표준 빌트인 객체인 Date는 날짜와 시간을 위한 메서드를 제공하는 빌트인 객체이면서 생성자 함수다.
UTC(협정 세계시)는 국제 표준시를 말한다.
KST(한국 표준시)는 UTC에 9시간을 더한 시간이다.
1) Date 생성자 함수
Date 생성자 함수로 생성한 Date 객체는 기본적으로 현재 날짜와 시간을 나타내는 정수값을 가진다.
new Date()
Date 생성자 함수를 인수 없이 new 연산자와 함께 호출하면 현재 날짜와 시간을 가지는 Date 객체를 반환한다.
new Date(); // -> Sat Dec 09 2023 17:21:26 GMT+0900 (한국 표준시)
Date 생성자 함수를 new 연산자 없이 호출하면 Date 객체를 반환하지 않고 날짜와 시간 정보를 나타내는 문자열을 반환한다.
Date(); // -> 'Sat Dec 09 2023 17:22:14 GMT+0900 (한국 표준시)'
new Date(milliseconds)
Date 생성자 함수에 숫자 타입의 밀리초를 인수로 전달하면 1970년 1월 1일 00:00:00(UTC)을 기점으로 인수로 전달된 밀리초만큼 경과한 날짜와 시간을 나타내는 Date 객체를 반환한다.
new Date(0); // -> Thu Jan 01 1970 09:00:00 GMT+0900 (한국 표준시)
/*
8640000ms는 1day를 의미한다.
1s = 1000ms
1m = 60s * 1000ms = 60000ms
1h = 60m * 60000ms = 3600000ms
1d = 24h *3600000ms = 86400000ms
*/
new Date(86400000); // -> Fri Jan 02 1970 09:00:00 GMT+0900 (한국 표준시)
new Date(dateString)
Date 생성자 함수에 날짜와 시간을 나타내는 문자열을 인수로 전달하면 지정된 날짜와 시간을 나타내는 Date 객체를 반환한다.
이때 인수로 전달한 문자열은 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'); // -> Tue May 26 2020 10:00:00 GMT+0900 (한국 표준시)
new Date(year, month[, day, hour, minute, second, millisecond])
Date 생성자 함수에 연, 월, 일, 시, 분, 초, 밀리초를 의미하는 숫자를 인수로 전달하면 지정된 날짜와 시간을 나타내는 Date 객체를 반환한다.
이때 연, 월은 반드시 지정해야 한다.
| 인수 | 내용 |
| year | 연을 나타내는 1900년 이후의 정수, 0부터 99는 1900부터 1999로 처리된다. |
| month | 월을 나타내는 0 ~ 11까지의 정수(주의: 0부터 시작, 0 = 1월) |
| day | 일을 나타내는 1 ~ 31까지의 정수 |
| hour | 시를 나타내는 0 ~ 23까지의 정수 |
| minute | 분을 나타내는 0 ~ 59까지의 정수 |
| second | 초를 나타내는 0 ~ 59까지의 정수 |
| millisecond | 밀리초를 나타내는 0 ~ 999까지의 정수 |
2) Date 메서드
Date.now
1970년 1월 1일 00:00:00(UTC)을 기점으로 현재 시간까지 경과한 밀리초를 숫자로 반환한다.
const now = Date.now();
new Date(now); // -> Sat Dec 09 2023 17:33:15 GMT+0900 (한국 표준시)
Date.parse
1970년 1월 1일 00:00:00(UTC)을 기점으로 인수로 전달된 지정 시간까지의 밀리초를 숫자로 반환한다.
Date.parse('Jan 2, 1970 09:00:00'); // -> 86400000
Date.UTC
1970년 1월 1일 00:00:00(UTC)을 기점으로 인수로 전달된 지정 시간까지의 밀리초를 숫자로 반환한다.
Date.UTC 메서드는 new Date(year, month[, day, hour, minute, second, millisecond])와 같은 형식의 인수를 사용해야 한다.
Date.UTC 메서드의 인수는 로컬 타임(KST)이 아닌 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
Date.prototype.getMonth
Date 객체의 월을 나타내는 0 ~ 11의 정수를 반환한다. 1월은 0, 12월은 11이다.
Date.prototype.setMonth
Date 객체의 월을 나타내는 0 ~ 11의 정수를 설정한다. 1월은 0, 12월은 11이다. 월 이외에 옵션으로 일도 설정할 수 있다.
Date.prototype.getDate
Date 객체의 날짜(1 ~ 31)을 나타내는 정수를 반환한다.
Date.prototype.setDate
Date 객체의 날짜(1 ~ 31)을 나타내는 정수를 설정한다.
Date.prototype.getDay
Date 객체의 요일(0 ~ 6)을 나타내는 정수를 반환한다. 일요일은 0, 토요일은 6이다.
Date.prototype.getHours
Date 객체의 시간(0 ~ 23)을 나타내는 정수를 반환한다.
Date.prototype.setHours
Date 객체의 시간(0 ~ 23)을 나타내는 정수를 설정한다. 시간 이외에 옵션으로 분, 초, 밀리초도 설정할 수 있다.
Date.prototype.getMinutes
Date 객체의 분(0 ~ 59)을 나타내는 정수를 반환한다.
Date.prototype.setMinutes
Date 객체의 분(0 ~ 59)을 나타내는 정수를 설정한다. 분 이외에 옵션으로 초, 밀리초도 설정할 수 있다.
Date.prototype.getSeconds
Date 객체의 초(0 ~ 59)을 나타내는 정수를 반환한다.
Date.prototype.setSeconds
Date 객체의 초(0 ~ 59)을 나타내는 정수를 설정한다. 초 이외에 옵션으로 밀리초도 설정할 수 있다.
Date.prototype.getMilliseconds
Date 객체의 밀리초(0 ~ 999)을 나타내는 정수를 반환한다.
Date.prototype.setMilliseconds
Date 객체의 밀리초(0 ~ 999)을 나타내는 정수를 설정한다.
Date.prototype.getTime
1970년 1월 1일 00:00:00(UTC)을 기점으로 Date 객체의 시간까지 경과된 밀리초를 반환한다.
Date.prototype.setTime
1970년 1월 1일 00:00:00(UTC)을 기점으로 경과된 밀리초를 설정한다.
Date.prototype.getTimezoneOffset
UTC와 Date 객체에 지정된 로캘(locale) 시간과의 차이를 분 단위로 반환한다.
const today = new Date();
today.getTimezoneOffset() / 60; // -9
Date.prototype.toDateString
사람이 읽을 수 있는 형식의 문자열로 Date 객체의 날짜를 반환한다.
Date.now()
today.toString(); // -> 'Sat Dec 09 2023 17:49:17 GMT+0900 (한국 표준시)'
today.toDateString(); // -> 'Sat Dec 09 2023'
Date.prototype.toTimeString
사람이 읽을 수 있는 형식으로 Date 객체의 시간을 표현한 문자열을 반환한다.
const today = new Date('2020/7/24/12:30');
today.toTimeString(); // -> '12:30:00 GMT+0900 (한국 표준시)'
Date.prototype.toISOString
ISO 8601 형식으로 Date 객체의 날짜와 시간을 표현한 문자열을 반환한다.
const today = new Date('2020/7/24/12:30');
today.toISOString(); // -> '2020-07-24T03:30:00.000Z'
today.toISOString().slice(0, 10); // -> '2020-07-24'
Date.prototype.toLocaleString
인수로 전달한 로캘을 기준으로 Date 객체의 날짜와 시간을 표현한 문자열을 반환한다. 인수를 생략한 경우 브라우저가 동작 중인 시스템의 로켈을 적용한다.
const today = new Date('2020/7/24/12:30');
today.toLocaleString(); // -> '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.toLocaleTimeString
인수로 전달한 로캘을 기준으로 Date 객체의 시간을 표현한 문자열을 반환한다. 인수를 생략한 경우 브라우저가 동작 중인 시스템의 로켈을 적용한다.
const today = new Date('2020/7/24/12:30');
today.toLocaleTimeString(); // ->'오후 12:30:00'
today.toLocaleTimeString('en-US'); // -> '12:30:00 PM'
today.toLocaleTimeString('ja-JP'); // -> '12:30:00'
출처: 이웅모, 『모던 자바스크립트 Deep Dive』 - 위키북스
'모던 자바스크립트' 카테고리의 다른 글
| [ 모던 자바스크립트 ] 32. String (0) | 2024.04.15 |
|---|---|
| [ 모던 자바스크립트 ] 31. RegExp (정규표현식) (1) | 2024.04.12 |
| [ 모던 자바스크립트 ] 29. Math (0) | 2024.04.11 |
| [ 모던 자바스크립트 ] 28. Number (0) | 2024.04.09 |
| [ 모던 자바스크립트 ] 27. 배열 (0) | 2024.04.08 |
