Date

• 표준 빌인 객체인 Date는 날짜와 시간을 위한 메서드를 제공하는 표준 빌트인 객체이면서 생성자 함수이다.

UTC, KST

• UTC는 국제 표준시를 말한다.(Universal Time Coordinated)
• KST는 UTC에 9시간을 더한 시간으로 한국 표준시를 말한다.(Korea Standard Time)
• 날짜와 시간은 JS코드가 실행되는 시스템의 시계에 의해 결정된다.

Date 생성자 함수

• Date 객체는 1970년 1월 1일 00:00:00부터 현재까지 밀리초를 나타내는 값을 가지고 있다.
• 이를 통해 Date 객체는 날짜와 시간을 나타내는 정수값을 가진다.

new Date()

• Date 생성자 함수를 인수 없이 new 연산자와 함께 호출하면 현재 날짜와 시간을 가지는 Date 객체가 반환된다.
• 만약 new 연산자없이 호출하면 날짜와 시간 정보를 나타내는 문자열을 반환한다.

new Date(); // -> Wed Aug 10 2022 01:03:18 GMT+0900 (대한민국 표준시)
Date(); // -> "Wed Aug 10 2022 01:10:47 GMT+0900 (대한민국 표준시)"

new Date(millisecons)

• Date 생성자 함수에 밀리초를 인수로 전달하면 1970년 1월 1일 00:00:00를 기준으로 전달된 인수만큼 경과한 날짜와 시간을 가지는 Date 객체를 반환한다.

// 한국 표준시 KST는 협정 세계시 UTC에 9시간을 더한 시간이다.
new Date(0); // -> Thu Jan 01 1970 09:00:00 GMT+0900 (대한민국 표준시)

/*
86400000ms는 1day를 의미한다.
1s = 1,000ms
1m = 60s * 1,000ms = 60,000ms
1h = 60m * 60,000ms = 3,600,000ms
1d = 24h * 3,600,000ms = 86,400,000ms
*/
new Date(86400000); // -> Fri Jan 02 1970 09:00:00 GMT+0900 (대한민국 표준시)

new Date(dateString)

• Date 생성자 함수에 날짜와 시간을 나타내는 문자열을 인수로 전달하면 지정된 날짜와 시간을 나타내는 Date 객체를 반환한다.

dateString

• RFC2822 또는 ISO 8601 날짜를 나타내는 문자열 (다른 형식도 사용할 수 있지만 예기치 않은 결과 일 수 있음)
• 수가 유효한 날짜를 나타내지 않으면 NaN이 반환됩니다.

ISO 8601

1. YYYY-MM-DDTHH:mm:ss.sssZ
2. YYYY-MM-DDThh:mm:ss+hh:mm

RFC2822

• 짧게 표시한 요일, 숫자로된 날짜, 월을 나타내는 세 글자 약어, 연도, 시간, 시간대를 포함하며, 01 Jun 2016 14:31:46 -0700과 같이 표시됩니다.

new Date('May 26, 2020 10:00:00');
// -> Tue May 26 2020 10:00:00 GMT+0900 (대한민국 표준시)

new Date('2020/03/26/10:00:00');
// -> Thu Mar 26 2020 10:00:00 GMT+0900 (대한민국 표준시)

var b = new Date('2019-05-20T00:10:20.000Z');
var c = new Date('2019-05-20 09:10:20');
var d = new Date('Mon May 20 2019 09:10:20 GMT+0900');
var e = new Date(2019, 4, 20, 9, 10, 20);

Date 메서드

Date.now

• 1970년 1월 1일 00:00:00을 기점으로 현재까지 경과한 밀리초를 반환한다.

const now = Date.now(); // -> 1593971539112

// Date 생성자 함수에 숫자 타입의 밀리초를 인수로 전달하면 1970년 1월 1일 00:00:00(UTC)을
// 기점으로 인수로 전달된 밀리초만큼 경과한 날짜와 시간을 나타내는 Date 객체를 반환한다.
// (30.1.2절 "new Date(milliseconds)" 참고)
new Date(now); // -> Mon Jul 06 2020 02:52:19 GMT+0900 (대한민국 표준시)

Date.parse

• 1970년 1월 1일 00:00:00부터 인수로 전달된 문자열(시간 형식)까지의 밀리초를 반환한다.
• 시간 형식은 new Date(dateString)의 인수와 동일한 형식이어야 한다.

// UTC
Date.parse('Jan 2, 1970 00:00:00 UTC'); // -> 86400000

// KST
Date.parse('Jan 2, 1970 09:00:00'); // -> 86400000

// KST
Date.parse('1970/01/02/09:00:00');  // -> 86400000

Date.UTC

• 1970년 1월 1일 00:00:00부터 인수로 전달된 문자열(시간 형식)까지의 밀리초를 반환한다.
• 시간 형식은 new Date(year, month, ...param)의 인수와 동일한 형식이어야 한다.
  이때, month는 0부터 11까지이므로 주의해야 한다.

Date.UTC(1970, 0, 2); // -> 86400000
Date.UTC('1970/1/2'); // -> NaN

Date.prototype.getFullYear

• Date 객체의 연도를 나타내는 정수를 반환한다.

Date.prototype.setFullYear

• Date 객체의 연도를 설정한다.
• 이 외에도 옵션으로 월, 일도 설정이 가능하다.

var t = new Date(1980,1,3);
t.setFullYear(1979,11,16);
alert(t); // 문자열, Sun Dec 16 1979 00:00:00 GMT+0900

Date.prototype.getMonth

• Date 객체의 월을 나타내는 0~11 정수를 반환한다.
• 1월은 0, 12월은 11이다.

Date.prototype.setMonth

• Date 객체의 월을 설정한다.
• 이때 설정값은 0부터 11까지이다.

Date.prototype.getDate

• Date 객체의 날짜(1~31)를 반환한다.

Date.prototype.setDate

• Date 객체의 날짜(1~31)를 설정한다.

Date.prototype.getTimezoneOffset

• UTC와 Date 객체에 저장된 locale 시간과의 차이를 분 단위로 반환한다.

const today = new Date(); // today의 지정 로캘은 KST다.

//UTC와 today의 지정 로캘 KST와의 차이는 -9시간이다.
today.getTimezoneOffset() / 60; // -9

Date.prototype.toDateString

• 사람이 읽을 수 있는 형식의 문자열로 Date 객체의 날짜를 반환한다.

const today = new Date('2020/7/24/12:30');

today.toString();     // -> Fri Jul 24 2020 12:30:00 GMT+0900 (대한민국 표준시)
today.toDateString(); // -> Fri Jul 24 2020

Date.prototype.toTimeString

• 사람이 읽을 수 있는 형식으로 Date 객체의 시간을 표현한 문자열을 반환한다.

const today = new Date('2020/7/24/12:30');

today.toString();     // -> Fri Jul 24 2020 12:30:00 GMT+0900 (대한민국 표준시)
today.toTimeString(); // -> 12:30:00 GMT+0900 (대한민국 표준시)

Date.prototype.toISOString

• ISO 8601 형식으로 Date 객체의 날짜와 시간을 표현한 문자열을 반환한다.

const today = new Date('2020/7/24/12:30');

today.toString();    // -> Fri Jul 24 2020 12:30:00 GMT+0900 (대한민국 표준시)
today.toISOString(); // -> 2020-07-24T03:30:00.000Z

today.toISOString().slice(0, 10); // -> 2020-07-24
today.toISOString().slice(0, 10).replace(/-/g, ''); // -> 20200724

Date.prototype.toLocaleString

• 인수로 전달한 locale 기준으로 Date 객체의 날짜와 시간을 표현한 문자열을 반환한다.
• 이때, 인수를 생략하면 자동으로 동작중인 시스템의 locale을 적용한다.

const today = new Date('2020/7/24/12:30');

today.toString(); // -> Fri Jul 24 2020 12:30:00 GMT+0900 (대한민국 표준시)
today.toLocaleString(); // -> 2020. 7. 24. 오후 12:30:00
today.toLocaleString('ko-KR'); // -> 2020. 7. 24. 오후 12:30:00
today.toLocaleString('en-US'); // -> 7/24/2020, 12:30:00 PM
today.toLocaleString('ja-JP'); // -> 2020/7/24 12:30:00

Date 연산

• Date 객체는 참조 값이기 때문에, 서로 다른 객체에 == 연산자를 쓸경우 false 가 반환된다.
• Date 객체 valueOf는 Unix Time 정수가 반환되기 때문에 비교 연산이 가능하다.
• 비교 연산자는 객체의 valueOf 나 toString 를 이용한 primitive 값의 비교가 가능하다.

var a = new Date('2019-05-20');
var b = new Date('2019-05-21');

console.log( a <= b );
// true
console.log( a.valueOf() <= b.valueOf() );
// true
console.log( a.toString() <= b.toString() );
// true

var c = new Date('2019-05-22');
var d = new Date('2019-05-22');
console.log( c == d );
// false