개요

Date 정보를 처리하기 위해 제공되는 오브젝트입니다.

지원 환경

- 스크립트의 Date 오브젝트에서 toLocaleDateString(), toLocaleString(), toLocaleTimeString () 메소드를 추가로 제공합니다.

- 넥사크로에서 제공하는 Date 오브젝트로 생성 시 "nexacro" 를 사용하여야 합니다.

- Date 오브젝트를 생성할 때 시간을 지정하지 않으면 시,분,초 값이 모두 0 으로 설정됩니다.

- datatyperule 속성값이 "2.0" 일 때 Invalid Value 를 가진 Date 오브젝트를 생성하려면 파라미터로 undefined 를 설정하여야 합니다.

생성자

new nexacro.Date( [nYear [, nMonth [, nDay [, nHours [, nMinutes [, nSeconds [,nMillisecond]]]]]]] )

// Create Object (Valid Value)
var objDate1 = new nexacro.Date();
var objDate2 = new nexacro.Date( 2000,1,1 );
var objDate3 = new nexacro.Date( 2000,1,1,9,0,0,0 );

// Create Object (Invalid Value)
var objDate4 = new nexacro.Date( undefined );

메서드

addDate

Date 오브젝트에 지정된 날짜(Day)만큼 더하는 메소드입니다.

지원 환경

문법

Date.addDate(nDays)

파라미터

var objDate = new nexacro.Date();
var nMs = objDate.addDate(30);

반환

활용 예제

• 연도와 주로 날짜 구간 계산하기

addHours

Date 오브젝트에 지정된 시간(Hour)만큼 더하는 메소드입니다.

지원 환경

문법

Date.addHours(nHours)

파라미터

var objDate = new nexacro.Date();
var nMs = objDate.addHours(10);

반환

addMilliseconds

Date 오브젝트에 지정된 밀리초(MilliSecond)만큼 더하는 메소드입니다.

지원 환경

문법

Date.addMilliseconds(nMsec)

파라미터

var objDate = new nexacro.Date();
var nMs = objDate.addMilliseconds(80);

반환

addMinutes

Date 오브젝트에 지정된 분(Minutes)만큼 더하는 메소드입니다.

지원 환경

문법

Date.addMinutes(nMinutes)

파라미터

var objDate = new nexacro.Date();
var nMs = objDate.addMinutes(5);

반환

addMonth

Date 오브젝트에 지정된 월(Month)만큼 더하는 메소드입니다.

지원 환경

문법

Date.addMonth(nMonths)

파라미터

var objDate = new nexacro.Date();
var nMs = objDate.addMonth(3);

반환

addSeconds

Date 오브젝트에 지정된 초(Second)만큼 더하는 메소드입니다.

지원 환경

문법

Date.addSeconds(nSeconds)

파라미터

var objDate = new nexacro.Date();
var nMs = objDate.addSeconds(30);

반환

addYear

Date 오브젝트에 지정된 년도(Year)만큼 더하는 메소드입니다.

지원 환경

문법

Date.addYear(nYears)

파라미터

var objDate = new nexacro.Date();
var nMs = objDate.addYear(3);

반환

getDate

Date 오브젝트에 저장된 값에서 날짜(Day)를 반환하는 메소드입니다.

지원 환경

문법

Date.getDate()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getDate());

반환

참고

- UTC(협정세계시)를 기준으로 날짜(Day)값을 가져오려고 하면 getUTCDate() 메소드를 사용해야 합니다.

활용 예제

• 오늘 날짜 구하기

getDay

Date 오브젝트에 저장된 값에서 요일를 반환하는 메소드입니다.

지원 환경

문법

Date.getDay()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getDay());

반환

참고

- UTC(협정세계시)를 기준으로 요일값을 가져오려고 하면 getUTCDay() 메소드를 사용해야 합니다.

- getDay() 메소드에서 반환되는 요일의 코드값은 아래와 같습니다.
   0 :일요일, 1 :월요일, 2 :화요일, 3 :수요일, 4 :목요일, 5 :금요일:, 6 :토요일

활용 예제

• 연도와 주로 날짜 구간 계산하기

getFullYear

Date 오브젝트에 저장된 값에서 네자리 년도(Year)를 반환하는 메소드입니다.

지원 환경

문법

Date.getFullYear()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getFullYear());

반환

참고

- UTC(협정세계시)를 기준으로 년도(Year)값을 가져오려고 하면 getUTCFullYear() 메소드를 사용해야 합니다.

- getFullYear() 메소드는 년도를 네자리로 반환합니다.
   getFullYear() 메소드를 사용하면 2000년대 년도와 1900년대 년도의 혼동을 피할 수 있습니다.

활용 예제

• 오늘 날짜 구하기

getHours

Date 오브젝트에 저장된 값에서 시(Hour)값을 반환하는 메소드입니다.

지원 환경

문법

Date.getHours()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getHours());

반환

참고

- UTC(협정세계시)를 기준으로 시(Hour)값을 가져오려고 하면 getUTCHours () 메소드를 사용해야 합니다.

- getHours() 메소드는 자정을 기준으로 0 부터 23 까지의 정수로 시간값을 반환합니다.
   메소드의 반환값이 0 일때는 오전 1시 이전이거나 Date 오브젝트를 생성할 때 시간을 지정하지 않은 경우입니다.
   Date 오브젝트를 생성할 때 시간을 지정하지 않으면 시,분,초 값이 모두 0 으로 출력됩니다.

getMilliseconds

Date 오브젝트에 저장된 값에서 밀리초(MilliSecond)값을 반환하는 메소드입니다.

지원 환경

문법

Date.getMilliseconds()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getMilliseconds());

반환

참고

- UTC(협정세계시)를 기준으로 밀리초(MilliSecon)값을 가져오려고 하면 getUTCMilliseconds() 메소드를 사용해야 합니다.

getMinutes

Date 오브젝트에 저장된 값에서 분(Minute)값을 반환하는 메소드입니다.

지원 환경

문법

Date.getMinutes()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getMinutes());

반환

참고

- UTC(협정세계시)를 기준으로 분(Minute)값을 가져오려고 하면 getUTCMinutes() 메소드를 사용해야 합니다.

- getMinutes() 메소드는 정시를 기점으로 0 부터 59 까지의 정수로 분(Minute)값을 반환합니다.
   메소드의 반환값이 0 일때는 정각에서 1분이 지나지 않았거나 Date 오브젝트를 생성할 때 시간을 지정하지 않은 경우입니다.
   Date 오브젝트를 생성할 때 시간을 지정하지 않으면 시,분,초 값이 모두 0 으로 출력됩니다.

getMonth

Date 오브젝트에 저장된 값에서 월(Month)값을 반환하는 메소드입니다.

지원 환경

문법

Date.getMonth()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getMonth());

반환

참고

- UTC(협정세계시)를 기준으로 월(Month)값을 가져오려고 하면 getUTCMonth() 메소드를 사용해야 합니다.

- getMonth() 메소드는 실제 사용하는 월(Month)값보다 1 작은 값을 반환합니다.
   예를 들어 1월의 경우 0 을 반환합니다.

활용 예제

• 오늘 날짜 구하기

getSeconds

Date 오브젝트에 저장된 값에서 초(Second)값을 반환하는 메소드입니다.

지원 환경

문법

Date.getSeconds()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getSeconds());

반환

참고

- UTC(협정세계시)를 기준으로 초(Second)값을 가져오려고 하면 getUTCSeconds() 메소드를 사용해야 합니다.

- getSeconds() 메소드는 정시를 기점으로 0부터 59까지의 정수로 시간 값을 반환합니다.
   메소드의 반환값이 0 일때는 1초가 지나지 않았거나 Date 오브젝트를 생성할 때 시간을 지정하지 않은 경우입니다.
   Date 오브젝트를 생성할 때 시간을 지정하지 않으면 시,분,초 값이 모두 0 으로 출력됩니다.

getTime

Date 오브젝트에 저장된 값을 밀리초(MilliSecond)값으로 반환하는 메소드입니다.

지원 환경

문법

Date.getTime()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getTime());

반환

참고

- getTime() 메소드가 처리할 수 있는 날짜 범위는 1970년 1월 1일 자정을 전후로 약 285,616년입니다.
   음수는 해당 날짜가 1970년 이전임을 나타냅니다.

- 날짜와 시간을 여러 번 계산할 때는 밀리초 값에 해당하는 변수를 아래 예제와 같이 일, 시, 분으로 정의하는 것이 좋습니다.

활용 예제

• 날짜 간 차이 계산하기

getTimezoneOffset

Date 오브젝트에 저장된 값과 UTC(협정세계시) 사이의 시간차를 분(Minute)값으로 반환하는 메소드입니다.

지원 환경

문법

Date.getTimezoneOffset()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getTimezoneOffset());

반환

활용 예제

• 세계 시간 표시하기

getUTCDate

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 날짜(Day)를 반환하는 메소드입니다.

지원 환경

문법

Date.getUTCDate()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getUTCDate());

반환

참고

- Date 오브젝트에 저장된 값을 기준으로 날짜(Day)값을 가져오려고 하면 getDate() 메소드를 사용해야 합니다.

getUTCDay

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 요일를 반환하는 메소드입니다.

지원 환경

문법

Date.getUTCDay()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getUTCDay());

반환

참고

- Date 오브젝트에 저장된 값을 기준으로 요일값을 가져오려고 하면 getDay() 메소드를 사용해야 합니다.

- getUTCDay() 메소드에서 반환되는 요일의 코드값은 아래와 같습니다.
   0 :일요일, 1 :월요일, 2 :화요일, 3 :수요일, 4 :목요일, 5 :금요일, 6 :토요일

getUTCFullYear

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 네자리 년도(Year)를 반환하는 메소드입니다.

지원 환경

문법

Date.getUTCFullYear()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getUTCFullYear());

반환

참고

- Date 오브젝트에 저장된 값을 기준으로 년도(Year)값을 가져오려고 하면 getFullYear() 메소드를 사용해야 합니다.

- getUTCFullYear() 메소드는 년도를 네자리로 반환합니다.
   getUTCFullYear() 메소드를 사용하면 2000년대 년도와 1900년대 년도의 혼동을 피할 수 있습니다.

getUTCHours

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 시(Hour)값을 반환하는 메소드입니다.

지원 환경

문법

Date.getUTCHours()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getUTCHours());

반환

참고

- Date 오브젝트에 저장된 값을 기준으로 시(Hour)값을 가져오려고 하면 getHours() 메소드를 사용해야 합니다.

- getUTCHours() 메소드는 자정을 기준으로 0 부터 23 까지의 정수로 시간값을 반환합니다.
   메소드의 반환값이 0 일때는 오전 1시 이전이거나 Date 오브젝트를 생성할 때 시간을 지정하지 않은 경우입니다.
   Date 오브젝트를 생성할 때 시간을 지정하지 않으면 시,분,초 값이 모두 0 으로 출력됩니다.

getUTCMilliseconds

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 밀리초(MilliSecond)값을 반환하는 메소드입니다.

지원 환경

문법

Date.getUTCMilliseconds()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getUTCMilliseconds());

반환

getUTCMinutes

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 분(Minute)값을 반환하는 메소드입니다.

지원 환경

문법

Date.getUTCMinutes()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getUTCMinutes());

반환

참고

- getUTCMinutes() 메소드는 정시를 기점으로 0 부터 59 까지의 정수로 분(Minute)값을 반환합니다.
   메소드의 반환값이 0 일때는 정각에서 1분이 지나지 않았거나 Date 오브젝트를 생성할 때 시간을 지정하지 않은 경우입니다.
   Date 오브젝트를 생성할 때 시간을 지정하지 않으면 시,분,초 값이 모두 0 으로 출력됩니다.

getUTCMonth

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 월(Month)값을 반환하는 메소드입니다.

지원 환경

문법

Date.getUTCMonth()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getUTCMonth());

반환

참고

- Date 오브젝트에 저장된 값을 기준으로 월(Month)값을 가져오려고 하면 getMonth() 메소드를 사용해야 합니다.

- getUTCMonth() 메소드는 실제 사용하는 월(Month)값보다 1 이 작은 값을 반환합니다.
   예를 들어 1월의 경우 0 을 반환합니다.

getUTCSeconds

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 초(Second)값을 반환하는 메소드입니다.

지원 환경

문법

Date.getUTCSeconds()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getUTCSeconds());

반환

참고

- getUTCSeconds 메소드는 정시를 기점으로 0부터 59까지의 정수로 시간 값을 반환합니다.
   메소드의 반환값이 0 일때는 1초가 지나지 않았거나 Date 오브젝트를 생성할 때 시간을 지정하지 않은 경우입니다.
   Date 오브젝트를 생성할 때 시간을 지정하지 않으면 시,분,초 값이 모두 0 으로 출력됩니다.

getYear

Date 오브젝트에 저장된 값에서 년도(Year)를 반환하는 메소드입니다.

지원 환경

문법

Date.getYear()

파라미터

var objDate = new nexacro.Date();

trace(objDate.getYear());

반환

참고

- getYear() 메소드는 이전 버전과의 호환성을 유지하기 위해서만 사용합니다.
   년도값을 가져오려면 getFullYear() 메소드를 사용하시기 바랍니다.

parse

날짜가 포함된 문자열을 분석해 1970년 1월 1일 자정부터 해당 날짜 사이의 시간을 밀리초로 반환하는 메소드입니다.

지원 환경

문법

Date.parse(strDate)

파라미터

var objDate = new nexacro.Date();
var nMs = objDate.parse("2021-06-29T11:00:00.000Z");

반환

참고

- 메소드에 사용하는 문자열은 ISO 8601 날짜 형식 또는 RFC2822 / IETF 날짜 형식을 따릅니다.

  * ECMA 표준 
    [http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.1.15]
  * ISO 8601 날짜형식 : YYYY-MM-DD'T'hh:mm:ss.sss'Z' 
    [http://www.iso.org/iso/home/standards/iso8601.htm]
  * RFC2822 / IETF 날짜형식 : 'May 21, 2012', 'Mon, 21 May 2012 03:20:00 +0900'
    [https://datatracker.ietf.org/doc/html/rfc2822#page-14]
  * Mozilla 웹브라우저 지원 형식
    [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse]


◆ WRE 제약

- ECMA5 표준에서는 ISO 8601 날짜 형식을 따르도록 명시되어 있습니다. 
  하지만 이전 ECMA 표준에서는 Date 표준 내장 객체의 toString 메소드 실행 결과를 해석하는 것으로 명시되어 있어 브라우저에 따라 동작이 다를 수 있으며 오류가 발생할 수 있습니다.

- 브라우저에 상관없이 같은 결과를 얻기 위해서는 아래 날짜 형식 문자열을 사용해야 합니다.
  YYYY-MM-DD (ISO 8601 날짜 형식, 예: 2021-06-29)
  YYYY-MM-DD'T'hh:mm:ss.sss'Z' (ISO 8601 조합된 UTC 날짜 및 시간, 예: 2021-06-29T11:00:00.000Z)
  MMM DD, YYYY (예: May 21, 2012)
  EEE, DD MMM YYYY hh:mm:ss Z (예: Mon, 21 May 2012 03:20:00 +0900)
  EEE, DD MMM YYYY hh:mm:ss z (예: Wed, 09 Aug 1995 00:00:00 GMT)
  EEE, DD MMM YYYY hh:mm:ss (예: Wed, 09 Aug 1995 00:00:00)

setDate

Date 오브젝트에 저장된 값에서 날짜(Day)를 변경하는 메소드입니다.

지원 환경

문법

Date.setDate(nDate)

파라미터

var objDate = new nexacro.Date();

traceobjDate.setDate(28));

반환

참고

- UTC(협정세계시)를 기준으로 날짜(Day)을 변경하려면 setUTCDate() 메소드를 사용해야 합니다.

- nDate에 지정된 날짜가 해당 월에 적용할 수 있는 날짜보다 크면 다음월 또는 다음년도로 처리됩니다.
   예를 들어 "January 5, 1996"에서 setDate(32)를 호출하는 경우에는 날짜가 "February 1, 1996"로 변경됩니다.
   반대로 nDate의 값이 음수인 경우에는 이전월 또는 이전년도로 처리됩니다.
   예를 들어 "January 5, 1996"에서 setDate(-32)를 호출하는 경우에는 날짜가 "November 29, 1995"로 변경됩니다.

setFullYear

Date 오브젝트에 저장된 값에서 년도(Year) 또는 전체 날짜를 변경하는 메소드입니다.

지원 환경

문법

Date.setFullYear(nYear[, nMonth[, nDate]])

파라미터

var objDate = new nexacro.Date();

trace(objDate.setFullYear(2009));
trace(objDate.setFullYear(2009,3,1));

반환

참고

- UTC(협정세계시)를 기준으로 년도(Year)을 변경하려면 setUTCFullYear() 메소드를 사용해야 합니다.

- 인수값이 범위를 초과하거나 음수이면 이에 따라 저장된 다른 값들이 수정될 수 있습니다.

setHours

Date 오브젝트에 저장된 값에서 시(Hour) 또는 전체 시간를 변경하는 메소드입니다.

지원 환경

문법

Date.setHours(nHours[, nMinutes[, nSeconds[, nMillisecond]]])

파라미터

var objDate = new nexacro.Date();

trace(objDate.setHours( 13 ));
trace(objDate.setHours( 13, 24 ));
trace(objDate.setHours( 13, 59, 59, 999 ));

반환

참고

- UTC(협정세계시)를 기준으로 시(Hour)를 변경하려면 setUTCHours() 메소드를 사용해야 합니다.

- 인수값이 범위를 초과하거나 음수이면 이에 따라 저장된 다른 값들이 수정될 수 있습니다.
   예를 들어 저장된 날짜가 "Jan 5, 1996 00:00:00"이고 setHours(30)을 실행하면 "Jan 6, 1996 06:00:00" 로 변경됩니다.
   음수값도 같은 방법으로 처리됩니다.

setMilliseconds

Date 오브젝트에 저장된 값에서 밀리초(MilliSecond)를 변경하는 메소드입니다.

지원 환경

문법

Date.setMilliseconds(nMilliSecond)

파라미터

var objDate = new nexacro.Date();

trace(objDate.setMilliseconds(568));

반환

참고

- UTC(협정세계시)를 기준으로 밀리초(MilliSecond)를 변경하려면 setUTCMilliseconds() 메소드를 사용해야 합니다.

- 인수값이 999보다 크거나 음수이면 이에 따라 저장된 다른 값들이 수정됩니다.

setMinutes

Date 오브젝트에 저장된 값에서 분(Minute)을 변경하는 메소드입니다.

지원 환경

문법

Date.setMinutes(nMinutes[, nSeconds[, nMillisecond]])

파라미터

var objDate = new nexacro.Date();

trace(objDate.setMinutes( 49 ));
trace(objDate.setMinutes( 49, 59 ));
trace(objDate.setMinutes( 49, 59, 999 ));

반환

참고

- UTC(협정세계시)를 기준으로 분(Minute)을 변경하려면 setUTCMinutes() 메소드를 사용해야 합니다.

- 인수값이 범위를 초과하거나 음수이면 이에 따라 저장된 다른 값들이 수정됩니다.
   예를 들어 저장된 날짜가 "Jan 5, 1996 00:00:00"이고 setMinutes(90)가 호출되면 날짜는 "Jan 5, 1996 01:30:00"로 바뀝니다.
   음수값도 같은 방법으로 처리됩니다.

setMonth

Date 오브젝트에 저장된 값에서 월(Month)을 변경하는 메소드입니다.

지원 환경

문법

Date.setMonth(nMonth[, nDate])

파라미터

var objDate = new nexacro.Date();

trace(objDate.setMonth( 3 ));
trace(objDate.setMonth( 3, 15 ));

반환

참고

- UTC(협정세계시)를 기준으로 월(Month)을 변경하려면 setUTCMonth() 메소드를 사용해야 합니다.

- nMonth 의 값이 11보다 크거나(1월이 0) 음수이면 이에 따라 저장된 다른 값들도 변경됩니다.
   예를 들어, 저장된 날짜가 "Jan 5, 1996"이고 setMonth(14) 가 실행되면 날짜는 "Mar 5, 1997" 로 변경됩니다.

setSeconds

Date 오브젝트에 저장된 값에서 초(Second)를 변경하는 메소드입니다.

지원 환경

문법

Date.setSeconds(nSeconds[, nMillisecond])

파라미터

var objDate = new nexacro.Date();

trace(objDate.setSeconds( 59 ));
trace(objDate.setSeconds( 59, 456 ));

반환

참고

- UTC(협정세계시)를 기준으로 초(Second)를 변경하려면 setUTCSeconds() 메소드를 사용해야 합니다.

- 인수의 값이 범위를 초과하거나 음수이면 이에 따라 저장된 다른 값들도 변경됩니다.
   예를 들어, 저장된 날짜가 "Jan 5, 1996 00:00:00" 이고 setSeconds(150) 가 실행되면 날짜는 "Jan 5, 1996 00:02:30" 로 변경됩니다.

setTime

Date 오브젝트에 날짜와 시간을 밀리초(MilliSecond)값으로 설정하는 메소드입니다.

지원 환경

문법

Date.setTime(nMs)

파라미터

var objDate = new nexacro.Date();

var nMs = objDate.setTime(199);   // 1 January 1970

반환

참고

- setTime() 메소드가 처리할 수 있는 날짜 범위는 1970년 1월 1일 자정을 전후로 약 285,616년입니다.
   음수는 해당 날짜가 1970년 이전임을 나타냅니다.

setUTCDate

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 날짜(Day)를 변경하는 메소드입니다.

지원 환경

문법

Date.setUTCDate(nDate)

파라미터

var objDate = new nexacro.Date();

trace(objDate.setUTCDate(31));

반환

참고

- 시스템의 로케일을 기준으로 날짜(Day)을 변경하려면 setDate() 메소드를 사용해야 합니다.

- nDate에 지정된 날짜가 해당 월에 적용할 수 있는 날짜보다 크면 다음월 또는 다음년도로 처리됩니다.
   예를 들어 "January 5, 1996"에서 setUTCDate(32)를 호출하는 경우에는 날짜가 "February 1, 1996"로 변경됩니다.
   반대로 nDate의 값이 음수인 경우에는 이전월 또는 이전년도로 처리됩니다.
   예를 들어 "January 5, 1996"에서 setUTCDate(-32)를 호출하는 경우에는 날짜가 "November 29, 1995"로 변경됩니다.

setUTCFullYear

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 년도(Year) 또는 전체 날짜를 변경하는 메소드입니다.

지원 환경

문법

Date.setUTCFullYear(nYears[, nMonths[, nDate]])

파라미터

var objDate = new nexacro.Date();

trace(objDate.setUTCFullYear(2009));
trace(objDate.setUTCFullYear(2009, 3, 15));

반환

참고

- 시스템의 로케일을 기준으로 날짜(Day)을 변경하려면 setFullYear() 메소드를 사용해야 합니다.

- 인수값이 범위를 초과하거나 음수이면 이에 따라 저장된 다른 값들이 수정될 수 있습니다.

setUTCHours

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 시(Hour) 또는 전체 시간를 변경하는 메소드입니다.

지원 환경

문법

Date.setUTCHours(nHours[, nMinutes[, nSeconds[, nMillisecond]]])

파라미터

var objDate = new nexacro.Date();

trace(objDate.setUTCHours(23));
trace(objDate.setUTCHours(23, 59));
trace(objDate.setUTCHours(23, 59, 59));
trace(objDate.setUTCHours(23, 59, 59, 999));

반환

참고

- 시스템의 로케일을 기준으로 시(Hour)를 변경하려면 setHours() 메소드를 사용해야 합니다.

- 인수값이 범위를 초과하거나 음수이면 이에 따라 저장된 다른 값들이 수정될 수 있습니다.
   예를 들어 저장된 날짜가 "Jan 5, 1996 00:00:00"이고 setUTCHours(30)을 실행하면 "Jan 6, 1996 06:00:00" 로 변경됩니다.
   음수값도 같은 방법으로 처리됩니다.

setUTCMilliseconds

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 밀리초(MilliSecond)를 변경하는 메소드입니다.

지원 환경

문법

Date.setUTCMilliseconds(nMs)

파라미터

var objDate = new nexacro.Date();

trace(objDate.setUTCMilliseconds(999));

반환

참고

- 시스템의 로케일을 기준으로 밀리초(MilliSecond)를 변경하려면 setMilliseconds() 메소드를 사용해야 합니다.

- 인수값이 999보다 크거나 음수이면 이에 따라 저장된 다른 값들이 수정됩니다.

setUTCMinutes

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 분(Minute)을 변경하는 메소드입니다.

지원 환경

문법

Date.setUTCMinutes(nMinutes[, nSeconds[, nMillisecond]])

파라미터

var objDate = new nexacro.Date();

trace(objDate.setUTCMinutes(59));
trace(objDate.setUTCMinutes(59,59));
trace(objDate.setUTCMinutes(59,59,999));

반환

참고

- 시스템의 로케일을 기준으로 분(Minute)을 변경하려면 setMinutes() 메소드를 사용해야 합니다.

- 인수값이 범위를 초과하거나 음수이면 이에 따라 저장된 다른 값들이 수정됩니다.
   예를 들어 저장된 날짜가 "Jan 5, 1996 00:00:00" 이고 setUTCMinutes(70)가 호출되면 날짜는 "Jan 5, 1996 01:10:00" 로 바뀝니다.
   음수값도 같은 방법으로 처리됩니다.

setUTCMonth

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 월(Month)을 변경하는 메소드입니다.

지원 환경

문법

Date.setUTCMonth(nMonth[, nDate])

파라미터

var objDate = new nexacro.Date();

trace(objDate.setUTCMonth(11));
trace(objDate.setUTCMonth(11,31));

반환

참고

- 시스템의 로케일을 기준으로 월(Month)을 변경하려면 setMonth() 메소드를 사용해야 합니다.

- nMonth 의 값이 11보다 크거나(1월이 0) 음수이면 이에 따라 저장된 다른 값들도 변경됩니다.
   예를 들어, 저장된 날짜가 "Jan 5, 1996"이고 setUTCMonth(14) 가 실행되면 날짜는 "Mar 5, 1997" 로 변경됩니다.

setUTCSeconds

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 값에서 초(Second)를 변경하는 메소드입니다.

지원 환경

문법

Date.setUTCSeconds(nSeconds[, nMillisecond])

파라미터

var objDate = new nexacro.Date();

trace(objDate.setUTCSeconds(59));
trace(objDate.setUTCSeconds(59,999));

반환

참고

- 시스템의 로케일을 기준으로 초(Second)를 변경하려면 setSeconds() 메소드를 사용해야 합니다.

- 인수의 값이 범위를 초과하거나 음수이면 이에 따라 저장된 다른 값들도 변경됩니다.
   예를 들어, 저장된 날짜가 "Jan 5, 1996 00:00:00" 이고 setUTCSeconds(150) 가 실행되면 날짜는 "Jan 5, 1996 00:02:30" 로 변경됩니다.

setYear

Date 오브젝트에 저장된 값에서 년도(Year)를 변경하는 메소드입니다.

지원 환경

문법

Date.setYear(nYears)

파라미터

var objDate = new nexacro.Date();

trace(objDate.setYear(2009));

반환

참고

- setYear() 메소드는 이전 버전과의 호환성을 유지하기 위해서만 사용합니다.
   년도값을 변경하려면 setFullYear() 메소드를 사용하시기 바랍니다.

- 1900년에서 1999년까지의 년도를 설정하는 경우에는 두 자리 정수를 지정합니다.
   예를 들어 1997년을 설정한다면 setYear(97)를 호출합니다.
   그 외의 날짜는 네 자리 정수를 지정합니다.

- 0년부터 99년 사이의 년도를 설정하려면 setFullYear() 메소드를 사용하여야 합니다.

toDateString

Date 오브젝트에 저장된 날짜를 문자열로 반환하는 메소드입니다.

지원 환경

문법

Date.toDateString()

파라미터

var objDate = new nexacro.Date();

trace(objDate.toDateString());

반환

참고

- Date 오브젝트에 저장된 시간을 문자열로 변환하려면 toTimeString() 메소드를 사용하여야 합니다.

toGMTString

GMT(그리니치 표준시)를 기준으로 Date 오브젝트에 저장된 날짜와 시간을 문자열로 반환하는 메소드입니다.

지원 환경

문법

Date.toGMTString()

파라미터

var objDate = new nexacro.Date();

trace(objDate.toGMTString());

반환

참고

- toGMTString() 메소드는 이전 버전과의 호환성을 유지하기 위해서만 사용합니다.
   UTC(협정세계시)를 사용하는 toUTCString() 메소드를 사용하시기 바랍니다.

- toGMTString() 메소드는 GMT 규칙을 사용하여 "Fri 05 Jan 1996 00:00:00 GMT"와 같이 서식이 적용된 값을 반환합니다.

toLocaleDateString

Date 오브젝트에 저장된 날짜를 특정 로케일 형식의 문자열로 반환하는 메소드입니다.

지원 환경

문법

Date.toLocaleDateString( [strLocale] )

파라미터

var objDate = new nexacro.Date();

trace(objDate.toLocaleDateString());
trace(objDate.toLocaleDateString( "ko_KR" ));

반환

참고

- 반환값은 시스템 설정에 따라 달라질 수 있으므로 표시용도로만 사용하고 계산식에서는 사용하지 않아야 합니다.
 
- 지원 가능한 로케일은 운영체제에 따라 달라질 수 있습니다.

- 로케일 코드는 "Appendix > Locale Code List" 항목을 참고하세요.

toLocaleString

Date 오브젝트에 저장된 날짜와 시간을 특정 로케일 형식의 문자열로 반환하는 메소드입니다.

지원 환경

문법

Date.toLocaleString( [strLocale] )

파라미터

var objDate = new nexacro.Date();

trace(objDate.toLocaleString());
trace(objDate.toLocaleString( "ko_KR" ));

반환

참고

- 반환값은 시스템 설정에 따라 달라질 수 있으므로 표시용도로만 사용하고 계산식에서는 사용하지 않아야 합니다.
 
- 지원 가능한 로케일은 운영체제에 따라 달라질 수 있습니다.

- 로케일 코드는 "Appendix > Locale Code List" 항목을 참고하세요.

toLocaleTimeString

Date 오브젝트에 저장된 시간을 특정 로케일 형식의 문자열로 반환하는 메소드입니다.

지원 환경

문법

Date.toLocaleTimeString( [strLocale] )

파라미터

var objDate = new nexacro.Date();

trace(objDate.toLocaleTimeString());
trace(objDate.toLocaleTimeString( "ko_KR" ));

반환

참고

- 반환값은 시스템 설정에 따라 달라질 수 있으므로 표시용도로만 사용하고 계산식에서는 사용하지 않아야 합니다.
 
- 지원 가능한 로케일은 운영체제에 따라 달라질 수 있습니다.

- 로케일 코드는 "Appendix > Locale Code List" 항목을 참고하세요.

toString

Date 오브젝트에 저장된 날짜와 시간값을 문자열로 반환하는 메소드입니다.

지원 환경

문법

Date.toString()

파라미터

var objDate = new nexacro.Date();

trace(objDate.toString());

반환

참고

- valueOf() 메소드와 동일한 메소드입니다.

toTimeString

Date 오브젝트에 저장된 시간을 문자열로 반환하는 메소드입니다.

지원 환경

문법

Date.toTimeString()

파라미터

var objDate = new nexacro.Date();

trace(objDate.toTimeString());

반환

참고

- Date 오브젝트에 저장된 날짜를 문자열로 변환하려면 toDateString() 메소드를 사용하여야 합니다.

toUTCString

UTC(협정세계시)를 기준으로 Date 오브젝트에 저장된 날짜와 시간을 문자열로 반환하는 메소드입니다.

지원 환경

문법

Date.toUTCString()

파라미터

var objDate = new nexacro.Date();

trace(objDate.toUTCString());

반환

참고

- toUTCString() 메소드는 UTC(협정세계시) 규칙을 사용하여 서식이 적용된 값을 반환합니다.

- OS와 브라우저에 따라 다른 형식으로 반환 될 수 있습니다.

UTC

UTC(협정세계시) 또는 GMT(그리니치 표준시)를 기준으로 1970년 1월 1일 자정부터 인수로 전달된 날짜까지의 시간을 밀리초(MilliSecond)값으로 반환하는 메소드입니다.

지원 환경

문법

Date.UTC(nYear, nMonth, nDay[, nHours[, nMinutes[, nSeconds[,nMillisecond]]]])

파라미터

var objDate = new nexacro.Date();
trace(objDate.UTC( 2009, 3, 1 ));
trace(objDate.UTC( 2009, 3, 1, 0, 0, 0, 0) );

반환

참고

- 인수값이 범위를 초과하거나 음수이면 저장된 다른 값들이 수정될 수 있습니다.
   예를 들어 nSeconds 값을 150으로 지정하게 되면 2분 30초로 처리합니다.

- 반환되는 값은 setTime() 메소드를 사용하여 설정할 수 있습니다.

   var objDate = new nexacro.Date();   
   var nMs = objDate.UTC(1999,0,1);
   var dDate = new nexacro.Date();
   dDate.setTime(nMs);
   trace(dDate.toString());     //  19990101090000000

- 날짜를 받아들이는 UTC() 메서드와 Date 개체 생성자 사이의 차이점은 UTC() 메서드는 UTC로 간주하고 Date 개체 생성자는 로컬 시간으로 간주한다는 것입니다. 

   var dDate = new nexacro.Date( 1970, 0, 1 );
   trace(dDate.getTime()); //  -32400000
   var objDate = new nexacro.Date();
   var nMs = objDate.UTC(1970, 0, 1);
   dDate = new nexacro.Date();
   dDate.setTime(nMs);
   trace(dDate.getTime());     // 0

valueOf

Date 오브젝트에 저장된 날짜와 시간값을 문자열로 반환하는 메소드입니다.

지원 환경

문법

Date.valueOf()

파라미터

var objDate = new nexacro.Date();

trace(objDate.valueOf());

반환

참고

- toString() 메소드와 동일한 메소드입니다.