25. 표준 빌트인 객체 - Date

Date

Date는 빌트인 객체이면서 생성자 함수이다.

• UTC: 국제 표준시
• KST: 한국 표준시, UTC에 9시간을 더한 시간으로 UTC보다 9시간 빠르다.
  UTC 00:00 AM = KST 09:00 AM
• 현재 날짜와 시간은 자바스크립트 코드가 실행된 시스템의 시계에 의해 결정된다.

 

Date 생성자 함수

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

• (내부적) 정수값은 1970년 1월 1일 00:00:00(UTC)을 기점으로 Date 객체가 나타내는 날짜와 시간까지의 밀리초를 나타낸다.
• (콘솔) 날짜와 시간 정보를 출력한다.

/*
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() vs Date()

• 인수 없이 new 연산자와 호출하면 현재 날짜와 시간 정보를 갖는 Date 객체를 반환한다.

console.log(new Date()); //Wed Aug 10 2022 18:57:01 GMT+0900 (한국 표준시)

• new 연산자 없이 호출하면 현재 날짜와 시간 정보를 갖는 문자열을 반환한다.

console.log(Date()); // "Wed Aug 10 2022 18:59:52 GMT+0900 (한국 표준시)"

 

new Date(milliseconds)

• 숫자 타입의 밀리초를 인수로 전달하면 1970년 1월 1일 00:00:00 (UTC)를 기점으로 인수로 전달된 밀리초만큼 경과된 날짜와 시간을 나타내는 Date 객체를 반환한다.

console.log(new Date(86400000)); Fri Jan 02 1970 09:00:00 GMT+0900 (한국 표준시)

 

new Date(dateString)

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

console.log(new Date('May 15, 2022 11:00:00')); // Sun May 15 2022 11:00:00 GMT+0900 (한국 표준시)

 

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

• 연, 월, 일, 시, 분, 초, 밀리초를 의미하는 숫자를 인수로 전달하면 지정된 날짜와 시간을 나타내는 Date 객체를 반환한다.
• 연, 월은 반드시 지정한다. 지정하지 않으면 1970년 1월 1일 00:00:00(UTC)을 나타내는 Date 객체를 반환한다.

// 월은 0 ~ 11까지의 정수로 나타낸다. 0부터 1월을 의미한다.
console.log(new Date(2022, 2)); // Tue Mar 01 2022 00:00:00 GMT+0900 (한국 표준시)

 

Date 메서드

Date.now

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

Date.now(); // 1660126500431

 

Date.parse

• 1970년 1월 1일 00:00:00(UTC)을 기점으로 인수로 전달된 시간까지의 밀리초를 숫자로 반환한다.

Date.parse('August 10, 2022 00:00:00 UTC'); // 1660089600000

 

Date.prototype.getFullYear

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

new Date('2022/08/10').getFullYear(); // 2022

Date.prototype.setFullYear

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

const today = new Date();

today.setFullYear(2000); // 965902835035
today.getFullYear(); // 2000

 

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); 
today.getMonth(); // 0

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

 

Date.prototype.getDay

• Date 객체의 요일(0 ~ 6)을 나타내는 정수를 반환한다.
• 일요일이 0, 토요일이 6이다.

new Date('2022/08/10').getDay(); // 3 (수요일)

 

Date.prototype.getHours

• Date 객체의 시간(0 ~ 23)을 나타내는 정수를 반환한다.

Date.prototype.setHours

• Date 객체의 시간(0 ~ 23)을 나타내는 정수를 설정한다. 시간 이외에 옵션으로 분, 초, 밀리초도 설정할 수 있다.

const today = new Date();

today.setHours(7); // 1660084017993
today.getHours(); // 7

 

Date.prototype.getSeconds

• Date 객체의 초(0 ~ 59)을 나타내는 정수를 반환한다.

Date.prototype.setSeconds

• Date 객체의 초(0 ~ 59)을 나타내는 정수를 설정한다. 초 이외에 옵션으로 밀리초도 설정할 수 있다.

const today = new Date();

today.setSeconds(30);
today.getSeconds(); // 30

 

Date.prototype.getMilliseconds

• Date 객체의 밀리초(0 ~ 999)을 나타내는 정수를 반환한다.

Date.prototype.setMilliseconds

• Date 객체의 밀리초(0 ~ 999)을 나타내는 정수를 설정한다. 초 이외에 옵션으로 밀리초도 설정할 수 있다.

 

Date.prototype.getTime

• 1970년 1월 1일 00:00:00(UTC)을 기점으로 Date 객체의 시간까지 경과된 밀리초를 반환한다.

new Date('2022/08/10/19:30').getTime(); // 1660127400000

Date.prototype.setTime

• 1970년 1월 1일 00:00:00(UTC)을 기점으로 경과된 밀리초를 설정한다.

const today = new Date();

today.setTime(86400000); // 86400000
console.log(today); // Fri Jan 02 1970 09:00:00 GMT+0900 (한국 표준시)

 

Date.prototype.getTimezoneOffset

• UTC와 Date 객체에 지정된 locale 시간과의 차이를 분 단위로 반환한다.
• KST는 UTC에 9시간을 더한 시간이다. ➡️ UTC = KST - 9h

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

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

 

Date.prototype.toDateString

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

Date.prototype.toTimeString

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

Date.prototype.toISOString

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

const today = new Date();

today.toISOString(); // '2022-08-10T10:39:16.479Z'
today.toISOString().slice(0, 10).replace(/-/g, ''); // '20220810'

 

Date.prototype.toLocaleString

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

today.toLocaleString('ko-KR'); // '2022. 8. 10. 오후 7:39:16'

Date.prototype.toLocaleTimeString

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

today.toLocaleTimeString('ko-KR'); // '오후 7:39:16'