JavaScript - 날짜표현 아직도 헷갈린다면 여기로

자바스크립트에서의 날짜 표현📆

​자바스크립트에서는 Date 객체를 사용하여 매 순간 변화하는 시간과 날짜에 관한 정보를 손쉽게 얻을 수 있습니다.

Date 객체는 연월일, 시분초의 정보와 함께 밀리초(millisecond)의 정보도 함께 제공합니다.

자바스크립트에서 날짜와 시간을 나타내기 위한 값의 범위는 다음과 같습니다.

1. 연도(year) : 1900년(00) ~ 1999년(99)
2. 월(month) : 1월(0) ~ 12월(11)
3. 일(day) : 1일(1) ~ 31일(31)
4. 시(hours) : 0시(0) ~ 23시(23)
5. 분(minutes) : 0분(0) ~ 59분(59)
6. 초(seconds) : 0초(0) ~ 59초(59)

Tip

자바스크립트에서 월(month)을 나타낼 때는 1월이 0으로 표현되고, 12월이 11로 표현된다는 사실에 유의해야 합니다.

UTC(협정 세계시: Coordinated Universal Time)는 GMT(그리니치 평균시: Greenwich Mean Time)로 불리기도 하는데 UTC와 GMT는 초의 소숫점 단위에서만 차이가 나기 때문에 일상에서는 혼용되어 사용됩니다.
기술적인 표기에서는 UTC가 사용됩니다.

​

KST(Korea Standard Time)는 UTC/GMT에 9시간을 더한 시간입니다. 즉, KST는 UTC/GMT보다 9시간이 빠릅니다.
예를 들어, UTC 00:00 AM은 KST 09:00 AM입니다.

​

현재의 날짜와 시간은 자바스크립트 코드가 동작한 시스템의 시계에 의해 결정됩니다.
시스템 시계의 설정(timezone, 시간)에 따라 서로 다른 값을 가질 수 있습니다.

Date Constructor

Date 객체는 생성자 함수이다.

Date 생성자 함수는 날짜와 시간을 가지는 인스턴스를 생성합니다.

생성된 인스턴스는 기본적으로 현재 날짜와 시간을 나타내는 값을 가집니다.

현재 날짜와 시간이 아닌 다른 날짜와 시간을 다루고 싶은 경우, Date 생성자 함수에 명시적으로 해당 날짜와 시간 정보를 인수로 지정합니다.

new Date()
인수를 전달하지 않으면 현재 날짜와 시간을 가지는 인스턴스를 반환합니다.

const date = new Date();
console.log(date); // Thu May 16 2019 17:16:13 GMT+0900 (한국 표준시)

new Date(milliseconds)
인수로 숫자 타입의 밀리초를 전달하면 1970년 1월 1일 00:00(UTC)을 기점으로 인수로 전달된 밀리초만큼 경과한 날짜와 시간을 가지는 인스턴스를 반환 합니다.

// KST(Korea Standard Time)는 GMT(그리니치 평균시: Greenwich Mean Time)에 
//														9시간을 더한 시간입니다.
let date = new Date(0); // 기점에서 0초 경과
console.log(date); // 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
date = new Date(86400000);
console.log(date); // Fri Jan 02 1970 09:00:00 GMT+0900 (한국 표준시)

new Date(dateString)
인수로 날짜와 시간을 나타내는 문자열을 전달하면 지정된 날짜와 시간을 가지는 인스턴스를 반환합니다.

이때 인수로 전달한 문자열은 Date.parse 메소드에 의해 해석 가능한 형식이어야 합니다.

let date = new Date('May 16, 2019 17:22:10');
console.log(date); // Thu May 16 2019 17:22:10 GMT+0900 (한국 표준시)
 
date = new Date('2019/05/16/17:22:10');
console.log(date); // Thu May 16 2019 17:22:10 GMT+0900 (한국 표준시)

new Date(year, month[, day, hour, minute, second, millisecond])
인수로 년, 월, 일, 시, 분, 초, 밀리초를 의미하는 숫자를 전달하면 지정된 날짜와 시간을 가지는 인스턴스를 반환합니다.

이때 년, 월은 반드시 지정하여야 한다. 지정하지 않은 옵션 정보는 0 또는 1으로 초기화 됩니다.

인수 내용
year 1900년 이후의 년
month 월을 나타내는 0 ~ 11까지의 정수 (주의: 0부터 시작, 0 = 1월)
day 일을 나타내는 1 ~ 31까지의 정수
hour 시를 나타내는 0 ~ 23까지의 정수
minute 분을 나타내는 0 ~ 59까지의 정수
second 초를 나타내는 0 ~ 59까지의 정수
millisecond 밀리초를 나타내는 0 ~ 999까지의 정수
​

년, 월을 지정하지 않은 경우 1970년 1월 1일 00:00(UTC)을 가지는 인스턴스를 반환합니다.

// 년, 월, 일, 시, 분, 초, 밀리초
 
// 월을 나타내는 4는 5월을 의미한다.
// 2019/5/1/00:00:00:00
let date = new Date(2019, 4);
console.log(date); // Wed May 01 2019 00:00:00 GMT+0900 (한국 표준시)
 
// 월을 나타내는 4는 5월을 의미한다.
// 2019/5/16/17:24:30:00
date = new Date(2019, 4, 16, 17, 24, 30, 0);
console.log(date); // Thu May 16 2019 17:24:30 GMT+0900 (한국 표준시)
 
// new Date(dateString) 형식이 가독성이 훨씬 좋다.
date = new Date('2019/5/16/17:24:30:10');
console.log(date); // Thu May 16 2019 17:24:30 GMT+0900 (한국 표준시)

Date 생성자 함수를 new 연산자없이 호출
Date 생성자 함수를 new 연산자없이 호출하면 인스턴스를 반환하지 않고 결과값을 문자열로 반환합니다.

let date = Date();
console.log(typeof date); // string 
console.log(date); // "Thu May 16 2019 17:33:03 GMT+0900 (한국 표준시)"
 
let date2 = new Date();
console.log(typeof date2); // object
console.log(date2); // Thu May 16 2019 17:33:03 GMT+0900 (한국 표준시) { }
 
// Object라 메소드를 사용할수 있다.
console.log(date2.getDay()); // 6

Date 메소드

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

Date.parse
1970년 1월 1일 00:00:00(UTC)을 기점으로 인수로 전달된 지정 시간(new Date(dateString)의 인수와 동일한 형식)까지의 밀리초를 숫자로 반환합니다.

let d = Date.parse('Jan 2, 1970 00:00:00 UTC'); // UTC
console.log(d); // 86400000
 
d = Date.parse('Jan 2, 1970 09:00:00'); // KST
console.log(d); // 86400000
 
d = Date.parse('1970/01/02/09:00:00'); // KST
console.log(d); // 86400000

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

Date.UTC메소드는 new Date(year, month[, day, hour, minute, second, millisecond])와 같은 형식의 인수를 사용해야 합니다.

Date.UTC 메소드의 인수는 local time(KST)가 아닌 UTC로 인식됩니다.

let d = Date.UTC(1970, 0, 2);
console.log(d); // 86400000
 
d = Date.UTC('1970/1/2');
console.log(d); // NaN

Date.prototype.getFullYear / Date.prototype.setFullYear
년도를 나타내는 4자리 숫자를 반환/설정한다. / 년도 이외에 월, 일도 설정 가능합니다.

const today = new Date();
 
// 년도 지정
today.setFullYear(2000);
 
console.log(today); // Tue May 16 2000 17:42:40 GMT+0900 (한국 표준시)
console.log(today.getFullYear());  // 2000
 
// 년도 월 일 지정
today.setFullYear(1900, 0, 1);
 
console.log(today); // Mon Jan 01 1900 17:42:40 GMT+0827 (한국 표준시)
console.log(today.getFullYear());  // 1900

Date.prototype.getMonth / Date.prototype.setMonth
월을 나타내는 0 ~ 11의 정수를 반환/설정한다. 1월은 0, 12월은 11이다. / 월 이외에도 일도 설정 가능합니다.

const today = new Date();
 
// 월을 지정
today.setMonth(0); // 1월
 
console.log(today); // Wed Jan 16 2019 17:45:20 GMT+0900 (한국 표준시)
console.log(today.getMonth()); // 0
 
// 월/일을 지정
today.setMonth(11, 1); // 12월 1일
 
console.log(today); // Sun Dec 01 2019 17:45:20 GMT+0900 (한국 표준시)
console.log(today.getMonth()); // 11

Date.prototype.getDate / Date.prototype.setDate
날짜(1 ~ 31)를 나타내는 정수를 반환/설정합니다.

const today = new Date();
 
// 날짜 지정
today.setDate(1);
 
console.log(today); // Wed May 01 2019 17:47:01 GMT+0900 (한국 표준시)
console.log(today.getDate());  // 1

Date.prototype.getDay
요일(0 ~ 6)를 나타내는 정수를 반환합니다. 반환값은 아래와 같습니다.

setDay는 없습니다. 요일을 지정하는건 의미없습니다. date를 지정하면 자동으로 요일이 결정되기 때문입니다.

요일 반환값
일요일 0
월요일 1
화요일 2
수요일 3
목요일 4
금요일 5
토요일 6
​

Date.prototype.getHours / Date.prototype.setHours
시간(0 ~ 23)를 나타내는 정수를 반환/설정합니다. / 시간 이외 분, 초, 밀리초도 설정할 수 있습니다.

const today = new Date();
 
// 시간 지정
today.setHours(7);
 
console.log(today); // Thu May 16 2019 07:49:06 GMT+0900 (한국 표준시)
console.log(today.getHours()); // 7
 
// 시간/분/초/밀리초 지정
today.setHours(0, 0, 0, 0); // 00:00:00:00
 
console.log(today); // Thu May 16 2019 00:00:00 GMT+0900 (한국 표준시)
console.log(today.getHours()); // 0

Date.prototype.getMinutes / Date.prototype.setMinutes
분(0 ~ 59)를 나타내는 정수를 반환/설정합니다. / 분 이외 초, 밀리초도 설정할 수 있습니다.

const today = new Date();
 
// 분 지정
today.setMinutes(50);
 
console.log(today);   // Thu May 16 2019 17:50:30 GMT+0900 (한국 표준시)
console.log(today.getMinutes()); // 50
 
// 분/초/밀리초 지정
today.setMinutes(5, 10, 999); // HH:05:10:999
 
console.log(today);   // Thu May 16 2019 17:05:10 GMT+0900 (한국 표준시)
console.log(today.getMinutes()); // 5

Date.prototype.getSeconds / Date.prototype.setSeconds
초(0 ~ 59)를 나타내는 정수를 반환/설정합니다. / 초 이외 밀리초도 설정할 수 있습니다.

const today = new Date();
 
// 초 지정
today.setSeconds(30);
 
console.log(today);   // Thu May 16 2019 17:54:30 GMT+0900 (한국 표준시)
console.log(today.getSeconds()); // 30
 
// 초/밀리초 지정
today.setSeconds(10, 0); // HH:MM:10:000
 
console.log(today);   // Thu May 16 2019 17:54:10 GMT+0900 (한국 표준시)
console.log(today.getSeconds()); // 10

Date.prototype.getMilliseconds / Date.prototype.setMilliseconds
밀리초(0 ~ 999)를 나타내는 정수를 반환/설정합니다.

const today = new Date();
 
// 밀리초 지정
today.setMilliseconds(123);
 
console.log(today); // Thu May 16 2019 17:55:45 GMT+0900 (한국 표준시)
console.log(today.getMilliseconds());    // 123

Date.prototype.getTime / Date.prototype.setTime
1970년 1월 1일 00:00:00(UTC)를 기점으로 현재 시간까지 경과된 밀리초를 반환/설정합니다.

위에서 배운, Date.parse(), Date.UTC의 함축 버젼이라고 보면 됩니다.

const today = new Date(); // Fri Jan 01 1970 09:00:00 GMT+0900 (한국 표준시)
 
// 1970년 1월 1일 00:00:00(UTC)를 기점으로 현재 시간까지 경과된 밀리초 지정
today.setTime(86400000); // 86400000 === 1day
 
console.log(today); // Fri Jan 02 1970 09:00:00 GMT+0900 (한국 표준시)
console.log(today.getTime());  // 86400000

Date.prototype.getTimezoneOffset
UTC와 지정 로케일(Locale) 시간과의 차이를 분단위로 반환합니다.

KST(Korea Standard Time)는 UTC에 9시간을 더한 시간입니다. 즉, UTC = KST - 9h입니다.

const today = new Date();
const x = today.getTimezoneOffset() / 60; // 분단위값을 60으로 나눈다
 
console.log(today); // Thu May 16 2019 17:58:13 GMT+0900 (한국 표준시)
console.log(x);     // -9

Date.prototype.toDateString
사람이 읽을 수 있는 형식의 문자열로 날짜를 반환합니다.

const d = new Date('2019/5/16/18:30');
 
console.log(d.toString());     // Thu May 16 2019 18:30:00 GMT+0900 (한국 표준시)
console.log(d.toDateString()); // Thu May 16 2019

Date.prototype.toTimeString
사람이 읽을 수 있는 형식의 문자열로 시간을 반환합니다.

const d = new Date('2019/5/16/18:30');
 
console.log(d.toString());     // Thu May 16 2019 18:30:00 GMT+0900 (한국 표준시)
console.log(d.toTimeString()); // 18:30:00 GMT+0900 (한국 표준시)

📝 현재 날짜와 시간을 초단위로 반복 출력하는 예제)

(function printNow() {
  const today = new Date();
 
  const dayNames = ['(일요일)', '(월요일)', '(화요일)', '(수요일)'
                    						, '(목요일)', '(금요일)', '(토요일)'];
  // getDay: 해당 요일(0 ~ 6)를 나타내는 정수를 반환한다.
  const day = dayNames[today.getDay()];
 
  const year = today.getFullYear();
  const month = today.getMonth() + 1;
  const date = today.getDate();
  let hour = today.getHours();
  let minute = today.getMinutes();
  let second = today.getSeconds();
 
  const ampm = hour >= 12 ? 'PM' : 'AM';
 
  // 12시간제로 변경
  hour %= 12;
  hour = hour || 12; // 12시,24시라서 나누어 떨어져서 0이면 12로 재설정 (12시간제)
 
  // 10미만인 분과 초를 2자리로 변경
  minute = minute < 10 ? '0' + minute : minute;
  second = second < 10 ? '0' + second : second;
 
  const now = `${year}년 ${month}월 ${date}일 ${day} ${hour}:${minute}:${second} ${ampm}`;
 
  console.log(now);
  setTimeout(printNow, 1000); // 1초마다 재귀처리
}());

날짜 계산 방법 정리

​몇일 전, 몇일 후 날짜 계산하는 방법

var now = new Date();	// 현재 날짜 및 시간
console.log("현재 : ", now);
 
var yesterday = new Date(now.setDate(now.getDate() - 1));	// 어제
console.log("어제 : ", yesterday);
 
var tomorrow = new Date(now.setDate(now.getDate() + 1));	// 내일
console.log("내일 : ", tomorrow);

몇달 전, 몇달 후 날짜 계산하는 방법

var now = new Date();	// 현재 날짜 및 시간
console.log("현재 : ", now);
 
var oneMonthAgo = new Date(now.setMonth(now.getMonth() - 1));	// 한달 전
console.log("한달 전 : ", oneMonthAgo);
 
var oneMonthLater = new Date(now.setMonth(now.getMonth() + 1));	// 한달 후
console.log("한달 후 : ", oneMonthLater);

몇년 전, 몇년 후 날짜 계산하는 방법

var now = new Date();	// 현재 날짜 및 시간
console.log("현재 : ", now);
 
var oneMonthAgo = new Date(now.setMonth(now.getMonth() - 1));	// 한달 전
console.log("한달 전 : ", oneMonthAgo);
 
var oneMonthLater = new Date(now.setMonth(now.getMonth() + 1));	// 한달 후
console.log("한달 후 : ", oneMonthLater);

자바스크립트 Date.prototype getter 메소드

메소드 / 설명 / 값의 범위
getDate() 현지 시각으로 현재 일자에 해당하는 숫자를 반환함. 1 ~ 31
getDay() 현지 시각으로 현재 요일에 해당하는 숫자를 반환함. 0 ~ 6
getMonth() 현지 시각으로 현재 월에 해당하는 숫자를 반환함. 0 ~ 11
getFullYear() 현지 시각으로 현재 연도를 4비트의 숫자(YYYY)로 반환함. YYYY
getHours() 현지 시각으로 현재 시각에 해당하는 숫자를 반환함. 0 ~ 23
getMilliseconds() 현지 시각으로 현재 시각의 밀리초에 해당하는 숫자를 반환함. 0 ~ 999
getMinutes() 현지 시각으로 현재 시각의 분에 해당하는 숫자를 반환함. 0 ~ 59
getSeconds() 현지 시각으로 현재 시각의 초에 해당하는 숫자를 반환함. 0 ~ 59
getTime() 1970년 1월 1일 0시 0분 0초부터 현재까지의 시간을 밀리초 단위로 환산한 값을 숫자로 반환함.
getTimezoneOffset() UTC로부터 현재 시각까지의 시간차를 분 단위로 환산한 값을 숫자로 반환함. -

자바스크립트 Date.prototype UTC getter 메소드

메소드 / 설명
getUTCDate() 협정세계시(UTC)로 현재 일자에 해당하는 숫자를 반환함.
getUTCDay() 협정세계시(UTC)로 현재 요일에 해당하는 숫자를 반환함.
getUTCMonth() 협정세계시(UTC)로 현재 월에 해당하는 숫자를 반환함.
getUTCFullYear() 협정세계시(UTC)로 현재 연도를 4비트의 숫자(YYYY)로 반환함.
getUTCHours() 협정세계시(UTC)로 현재 시각에 해당하는 숫자를 반환함.
getUTCMilliseconds() 협정세계시(UTC)로 현재 시각의 밀리초에 해당하는 숫자를 반환함.
getUTCMinutes() 협정세계시(UTC)로 현재 시각의 분에 해당하는 숫자를 반환함.
getUTCSeconds() 협정세계시(UTC)로 현재 시각의 초에 해당하는 숫자를 반환함.

자바스크립트 Date.prototype setter 메소드

메소드 / 설명 / 값의 범위
setDate() 현지 시각으로 특정 일자를 설정함. 1 ~ 31
setMonth() 현지 시각으로 특정 월을 설정함. 0 ~ 11
setFullYear() 현지 시각으로 특정 연도를 설정함. (연도뿐만 아니라 월과 일자도 설정할 수 있음) YYYY, MM, DD
setHours() 현지 시각으로 특정 시간을 설정함. 0 ~ 23
setMilliseconds() 현지 시각으로 특정 밀리초를 설정함. 0 ~ 999
setMinutes() 현지 시각으로 특정 분을 설정함. 0 ~ 59
setSeconds() 현지 시각으로 특정 초를 설정함. 0 ~ 59
setTime() 1970년 1월 1일 0시 0분 0초부터 밀리초 단위로 표현되는 특정 시간을 설정함. -

✔Tip

자바스크립트에서 setDay() 메소드는 존재하지 않습니다.

자바스크립트 Date.prototype UTC setter 메소드

메소드 / 설명 / 값의 범위
setUTCDate() 협정세계시(UTC)로 특정 일자를 설정함. 1 ~ 31
setUTCMonth() 협정세계시(UTC)로 특정 월을 설정함. 0 ~ 11
setUTCFullYear() 협정세계시(UTC)로 특정 연도를 설정함. (연도뿐만 아니라 월과 일자도 설정할 수 있음) YYYY, MM, DD
setUTCHours() 협정세계시(UTC)로 특정 시간을 설정함. 0 ~ 23
setUTCMilliseconds() 협정세계시(UTC)로 특정 밀리초를 설정함. 0 ~ 999
setUTCMinutes() 협정세계시(UTC)로 특정 분을 설정함. 0 ~ 59
setUTCSeconds() 협정세계시(UTC)로 특정 초를 설정함. 0 ~ 59