[JS] DeepDive(30) Date

 

 

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

 

 

Date는 생성자 함수로 Date 객체는 내부적으로 날짜와 시간을 나타내는 정수값을 가진다.

 

해당 값은 1970년 1월 1일 00:00:00(UTC)를 기점으로 Date 객체가 나타내는 날짜와 시간까지의 밀리초를 나타낸다.

 

Date 생성자 함수로 객체를 생성하는 방법은 4가지가 있다.

 

 

 

1. new Date()

현재 날짜와 시간을 가지는 Date객체를 반환한다.

2. new Date(milliseconds)

1970년 1월 1일을 기점으로 인수로 전달된 밀리초만큼 경과한 날짜와 시간을 나타내는 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 (대한민국 표준시)

 

 

 

3. new Date(dateString)

날짜와 시간을 나타내는 문자열을 전달해야한다. Date.parse메서드에 의해 분석 가능한 형식인 경우에만 가능하다.

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 (대한민국 표준시)

 

 

4, new Date(year,month[,day,hour,minute,second,millisecond])

 

// 월을 나타내는 2는 3월을 의미한다. 2020/3/1/00:00:00:00
new Date(2020, 2);
// -> Sun Mar 01 2020 00:00:00 GMT+0900 (대한민국 표준시)

// 월을 나타내는 2는 3월을 의미한다. 2020/3/26/10:00:00:00
new Date(2020, 2, 26, 10, 00, 00, 0);
// -> Thu Mar 26 2020 10:00:00 GMT+0900 (대한민국 표준시)

// 다음처럼 표현하면 가독성이 훨씬 좋다.
new Date('2020/3/26/10:00:00:00');
// -> Thu Mar 26 2020 10:00:00 GMT+0900 (대한민국 표준시)

 

 

 

 

 

 

Date 메서드

 

Date.now

1970년 1월 1일을 기점으로 현재 시간까지 경과한 밀리초를 숫자로 반환

 

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

인수로 지정된 지정시간까지의 밀리초를 숫자로 바노한한다.

 

 

// 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

인수로 전달된 지정시간까지의 밀리초를 시간으로 반환한다.

 

 

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

 

Date.prototype.getFullYear

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

 

new Date('2020/07/24').getFullYear(); // -> 2020

 

 

Date.prototype.setFullYear

Date 객체에 연도를 나타내는 정수를 설정한다. 연도 이외에 옵션으로 월,일도 설정할 수 있다.

 

const today = new Date();

// 년도 지정
today.setFullYear(2000);
today.getFullYear(); // -> 2000

// 년도/월/일 지정
today.setFullYear(1900, 0, 1);
today.getFullYear(); // -> 1900

 

Date.prototype.getMonth

Date객체의 월을 나타내는 0~11의 정수를 반환한다.

 

new Date('2020/07/24').getMonth(); // -> 6

 

 

Date.prototype.setMonth

Date 객체에 월을 나타내는 0~11의 정수를 설정한다.

 

const today = new Date();

// 월 지정
today.setMonth(0); // 1월
today.getMonth(); // -> 0

// 월/일 지정
today.setMonth(11, 1); // 12월 1일
today.getMonth(); // -> 11

 

 

 

Date.prototype.getDate

Date 객체의 날짜를 나타내는 정수를 반환한다.

 

new Date('2020/07/24').getDate(); // -> 24

 

 

Date.prototype.setDate

Date 객체에 날짜(1~31)를 나타내는 정수를 설정한다.

 

const today = new Date();

// 날짜 지정
today.setDate(1);
today.getDate(); // -> 1

 

 

 

 

 

Date.prototype.getDay

Date객체의 요일을 나타내는 정수를 반환한다.

 

new Date('2020/07/24').getDay(); // -> 5

 

 

Date.prototype.getHours

Date 객체의 시간을 나타내는 정수를 반환

new Date('2020/07/24/12:00').getHours(); // -> 12

 

 

 

 

Date.prototype.setHours

Date 객체에 시간을 나타내는 정수를 설정한다.

 

const today = new Date();

// 시간 지정
today.setHours(7);
today.getHours(); // -> 7

// 시간/분/초/밀리초 지정
today.setHours(0, 0, 0, 0); // 00:00:00:00
today.getHours(); // -> 0

 

 

 

Date.prototype.getMinutes

Date객체의 분을 나타내는 정수를 반환

new Date('2020/07/24/12:30').getMinutes(); // -> 30

 

 

 

 

Date.prototype.setMinutes

Date객체에 분을 나타내는 정수를 설정한다.

 

const today = new Date();

// 분 지정
today.setMinutes(50);
today.getMinutes(); // -> 50

// 분/초/밀리초 지정
today.setMinutes(5, 10, 999); // HH:05:10:999
today.getMinutes(); // -> 5

 

 

 

Date.prototype.getSeconds

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

 

new Date('2020/07/24/12:30:10').getSeconds(); // -> 10

 

 

Date.prototype.setSeconds

Date객체에 초를 나타내는 정수를 설정한다. 초 이외에 옵션으로 밀리초를 설정하는것도 가능하다.

 

const today = new Date();

// 초 지정
today.setSeconds(30);
today.getSeconds(); // -> 30

// 초/밀리초 지정
today.setSeconds(10, 0); // HH:MM:10:000
today.getSeconds(); // -> 10

 

 

 

 

Date.prototype.getMilliseconds

Date 객체의 밀리초를 나타내는 정수를 반환한다.

 

new Date('2020/07/24/12:30:10:150').getMilliseconds(); // -> 150

 

 

Date.prototype.setMilliseconds

Date 객체에 밀리초를 나타내는 정수를 설정

 

const today = new Date();

// 밀리초 지정
today.setMilliseconds(123);
today.getMilliseconds(); // -> 123

 

 

 

Date.prototype.getTime

1970년 1월 1일을 기점으로 Date 객체의 시간까지 경과된 밀리초를 반환

 

new Date('2020/07/24/12:30').getTime(); // -> 1595561400000

 

 

Date.prototype.setTime

1970년 1월 1일을 기점으로 경과된 밀리초를 설정

 

const today = new Date();

// 1970년 1월 1일 00:00:00(UTC)를 기점으로 경과된 밀리초 설정
today.setTime(86400000); // 86400000는 1day를 나타낸다.
console.log(today); // -> Fri Jan 02 1970 09:00:00 GMT+0900 (대한민국 표준시)

 

 

Date.prototype.getTimezoneOffset

UTC와 Date객체에 지정된 로캘시간과의 차이를 분 단위로 반환한다. KST는 UTC에 9시간을 더한 시간이다.

 

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

인수로 전달한 로캘을 기준으로 Date객체의 날짜와 시간을 표현한 문자열을 반환한다. 인수를 생략한 경우 브라우저가 동작 중인 시스템의 로캘을 적용한다.

 

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.prototype.toLocalTimeString

인수로 전달한 로캘을 기준으로 Date객체의 시간을 표현한 문자열을 반환한다.

 

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

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