NATIVE

settings_applicationsObject

NATIVE

Editing
  • account_tree
  • bug_report

ObjectDate

현재 시점 또는 특정 날짜와 시간을 데이터로 다루는 객체이다.

설명

ECMAScript에서 Date 객체는 기본적으로 197011일 0시를 기점으로 이후 경과된 밀리초(milliseconds)로 날짜를 연산하는 UTC를 따른다. UTC는 그리니치 평균시를 기반으로 하나 Date 객체는 현지 시간대 및 오프셋으로 작동한다.

밀리초(milliseconds)

1초를 1000으로 나눈 시간을 의미한다. 자바스크립트 환경에서 기본으로 사용하는 시간 단위이다.

Date 객체가 표현할 수 있는 밀리초(milliseconds)는 안전하게 표현되는 최대 정수 값(Number.MAX_SAFE_INTEGER)보다 약간 적다. 최대 ±8,640,000,000,000,000밀리초이다. 즉 기원전 271821420일부터 서기 275760913일까지 표현이 가능하다. 그 외는 NaN으로 처리한다.

NaN

"Not a Number"를 의미한다. 즉 "숫자가 아니다"라는 뜻을 가진 키워드이다.

하위 트리 탐색

  • Constructor

    날짜와 시간 데이터를 생성하는 생성자이며 new 연산자를 사용한 Date() 생성자 함수만 생성이 가능하다.

    • Date()

      날짜와 시간 데이터를 생성하는 생성자 함수이며 new 연산자를 이용한 생성만 허용된다.

  • [[Prototype]]

    • Methods

      • @@toPrimitive

        Date 객체의 날짜를 나타내는 기본 값을 반환한다.

        Well-know symbol

        @@ 접두어는 잘 알려진 심벌(well-know-symbol)을 나타내는 표기법이다.

        웰 노우 심벌(Well-known Symbols)은 특정 객체의 작업을 위한 프토토콜(protocol) 역할을 한다. 프로토콜은 ECMAScript 6에 추가된 새로운 개념이다. 일종의 규칙을 의미하며 약속된 규칙(잘 알려진 심벌을 키로 사용, 약속된 일관된 결과)을 반영한 메소드나 프로퍼티를 객체에 추가한다. 이러한 객체를 프로토콜을 준수하는 객체라는 표현을 쓴다. 각 프로토콜의 사용하는 방법은 해당 구문을 참고하기 바란다.

      • getDate()

        Date 객체의 지정된 날짜를 반환한다.

      • getDay()

        Date 객체가 생성된 시점의 요일 코드를 반환한다. 일요일부터 토요일 순으로 0~6까지의 코드로 반환한다.

      • getFullYear()

        Date 객체가 생성된 시점의 4자리 년도를 반환한다.

      • getHours()

        Date 객체가 생성된 시점의 시간을 반환한다.

      • getMilliseconds()

        Date 객체가 생성된 시점의 밀리초(milliseconds)를 반환한다.

      • getMinutes()

        Date 객체가 생성된 시점의 분을 반환한다.

      • getMonth()

        Date 객체가 생성된 시점의 월을 가리키는 인덱스를 반환한다.

      • getSeconds()

        Date 객체가 생성된 시점의 초를 반환한다.

      • getTime()

        Date 객체가 생성된 시점까지 1970110시부터 경과된 밀리초(milliseconds)를 반환한다.

      • getTimezoneOffset()

        Date 객체가 생성된 시점의 현재 지역에 대한 시간대 오프셋(UTC)을 분 단위로 반환한다.

      • getUTCDate()

        Date 객체가 생성된 시점에서 지정된 날짜에 해당하는 표준시에 따른 날짜를 반환한다.

      • getUTCDay()

        Date 객체가 생성된 시점에서 지정된 날짜의 요일을 가리키는 인덱스를 표준시에 따른 인덱스로 반환한다.

      • getUTCFullYear()

        Date 객체가 생성된 시점의 지정된 날짜의 표준시에 따른 네 자리 연도를 반환한다.

      • getUTCHours()

        Date 객체가 생성된 시점의 지정된 날짜의 표준시에 따른 시간을 반환한다.

      • getUTCMilliseconds()

        Date 객체가 생성된 시점의 지정된 날짜의 표준시에 따른 밀리(milliseconds) 초를 반환한다.

      • getUTCMinutes()

        Date 객체가 생성된 시점의 지정된 날짜에서 표준시에 따른 분을 반환한다.

      • getUTCMonth()

        Date 객체가 생성된 시점의 지정된 날짜에서 표준시에 따른 월을 가리키는 인덱스를 반환한다.

      • getUTCSeconds()

        Date 객체가 생성된 시점의 지정된 날짜에서 표준시에 따른 초을 반환한다.

      • setDate()

        Date 객체의 날짜를 변경한다.

      • setFullYear()

        Date 객체에 새로운 네자리 연도를 설정한다. 선택적으로 월과 일도 변경할 수 있다.

      • setHours()

        Date 객체의 시간를 변경한다. 선택적으로 분과 초 그리고 밀리초(milliseconds)도 함께 변경이 가능하다.

      • setMilliseconds()

        Date 객체의 밀리초(milliseconds)를 변경한다.

      • setMinutes()

        Date 객체의 분을 변경한다. 선택적으로 초와 밀리초(milliseconds)도 함께 변경이 가능하다.

      • setMonth()

        Date 객체의 월을 가리키는 인덱스(0~6)를 변경한다. 선택적으로 일도 함께 변경이 가능하다.

      • setSeconds()

        Date 객체의 초를 변경한다. 선택적으로 밀리초(milliseconds)도 함께 변경이 가능하다.

      • setTime()

        1970110시 부터 경과된 Date 객체의 밀리초(milliseconds)를 변경한다. setMilliseconds() 메소드와 다르므로 주의한다.

      • setUTCDate()

        표준시에 따른 Date 객체의 날짜를 변경한다.

      • setUTCFullYear()

        표준시에 따른 Date 객체의 네자리 년도를 변경한다. 선택적으로 월과 일도 함께 변경이 가능하다.

      • setUTCHours()

        표준시에 따른 Date 객체의 시간를 변경한다. 선택적으로 분과 초, 그리고 밀리초(milliseconds)도 함께 변경이 가능하다.

      • setUTCMilliseconds()

        표준시에 따른 Date 객체의 밀리초(milliseconds)를 변경한다.

      • setUTCMinutes()

        표준시에 따른 Date 객체의 분을 변경한다. 선택적으로 초와 밀리초(milliseconds)도 함께 변경이 가능하다.

      • setUTCMonth()

        표준시에 따른 Date 객체의 월을 가리키는 인덱스(0~6)를 변경한다. 선택적으로 일도 함께 변경이 가능하다.

      • setUTCSeconds()

        표준시에 따른 Date 객체의 초를 변경한다. 선택적으로 밀리초(milliseconds)도 함께 변경이 가능하다.

      • toDateString()

        Date 객체가 생성된 시점의 현지 시간대로 해석된 날짜 부분을 나타내는 문자열을 반환한다. 기본적으로 미국 영어권 사용 형식의 문자열로 반환한다. 현지화된 형식을 원한다면 toLocaleDateString() 사용한다.

      • toISOString()

        Date 객체가 생성된 시점의 날짜와 시간을 길이가 항상 24자 또는 27자 ( YYYY-MM-DDTHH:mm:ss.sssZ 또는 ±YYYYYY-MM-DDTHH:mm:ss.sssZ)인 단순화된 확장 ISO 형식( ISO 8601 )으로 문자열을 반환한다. 표준 시간대는 접미사 "Z" 로 표시되며 항상 0 UTC 오프셋이다.

      • toJSON()

        Date 객체가 생성된 시점의 날짜와 시간을 나타내는 ISO 형식의 문자열을 반환한다.  toISOString()과 반환값이 동일하다.

      • toLocaleDateString()

        Date 객체가 생성된 시점의 날짜 부분을 현지 사용 언어에 맞는 문자열 형식으로 반환한다.

      • toLocaleString()

        Date 객체가 생성된 시점의 날짜의 문자열 표현을 지역의 언어에 맞는 형식으로 반환한다.

      • toLocaleTimeString()

        Date 객체가 생성된 시점의 시간 부분을 현지 사용 언어에 맞는 문자열 형식으로 반환한다.

      • toString()

        Date 객체가 생성된 시점의 날짜와 시간을 현지 시간대로 해석된 Date 객체를 나타내는 문자열을 반환한다.

      • toTimeString()

        Date 객체가 생성된 시점의 현지 시간대로 해석된 시간 부분을 나타내는 문자열을 반환한다. 기본적으로 미국 영어권 사용 형식의 문자열로 반환한다. 현지화된 형식을 원한다면 toLocaleTimeString() 사용한다.

      • toUTCString()

        Date 객체가 생성된 시점의 UTC 시간대로 음수 연도가 허용되는 RFC 7231 형식의 날짜를 표시하는 문자열을 반환한다.

      • valueOf()

        UTC 기준으로 1970110시로 정의된 에포크(epoch) 이후 Date 객체가 생성된 시점까지 경과한 밀리초(milliseconds)를 반환한다.

  • Static

    정적(static) 멤버를 의미하며 인스턴스(instance)에 상속되어 사용할 수 없고 오로지 하위를 포함하여 객체(object) 또는 인터페이스(interface) 자신에서 해당 멤버에 접근이 가능하다. 

    • Methods

      • now()

        현재 시간을 UTC 기준 1970110시부터 경과된 밀리초(Millisecond)로 반환한다.

      • parse()

        인수로 지정된 문자열 데이터를 분석해 UTC로 계산이 가능한 경우에는 밀리초(millisecond)로 반환하거나 분석이 불가능한 경우에는 NaN을 반환한다.

      • UTC()

        날짜 형식에 따른 날짜 데이터를 매개 변수로 받아 1970110UTC 부터 경과한 시간을 밀리초(millisecond)로 반환한다.

지원 웹브라우저