$date

Namespace

$date

Description:

  • 날짜 유틸리티

Author:
  • 이승갑 (dltmdrkq2@gmail.com)
  • 정민석 (whitn86@gmail.com)

Members

(static, readonly) today :string

Description:

  • Client의 현재 날짜(숫자8자리)

Client의 현재 날짜(숫자8자리)

Type:
  • string
Example
var now = $date.today;

(static, readonly) todayTime :string

Description:

  • Client의 현재 날짜 및 시간(ms까지)

Client의 현재 날짜 및 시간(ms까지)

Type:
  • string
Example
var dateTime = $date.todayTime;

Methods

(static) addDate(date, days) → {string}

Description:

  • 입력된 문자열의 날짜에 특정 일 수를 더한 날짜를 구함

Example
var origin = "19450815";
var sDate = $date.addDate(origin, 10);
	
var date = new Date();
var sDate2 = $date.addDate(date, 10);
Parameters:
Name Type Description
date string | Date

날짜를 계산하고자 하는 8자리 문자열 또는 날짜
days number

더할 일 수
음수 입력 시 이전 날짜를 구합니다.
Returns:

일 수가 계산된 날짜(8자리숫자)

Type
string

(static) addMonth(date, month) → {string}

Description:

  • 입력된 문자열의 날짜에 특정 일 수를 더한 날짜를 구함

Example
var origin = "19450815";
var sDate = $date.addMonth(origin, 3);
	
var date = new Date();
var sDate2 = $date.addMonth(date, 3);
Parameters:
Name Type Description
date string | Date

날짜를 계산하고자 하는 8자리 문자열 또는 날짜
month number

더할 달 수
음수 입력 시 이전 날짜를 구합니다.
Returns:

개원 수가 계산된 날짜(8자리숫자)

Type
string

(static) calcDate(year, month, dateopt) → {string}

Description:

  • 년 월 일을 입력받아 날짜를 계산한다.

    비정상적이거나 존재하지 않는 범위의 년,월,일 값을 올바른 값으로 만들수도 있습니다
    ex) 2020,02,31 -> 20200302

Example
var dateTime = $date.calcDate(2020,02,31);
Parameters:
Name Type Attributes Default Description
year number | string

년도
month number | string

월
date number | string <optional>
 1

일
Returns:

계산된 날짜(숫자8자리)

Type
string

(static) calcLastDateNum(date) → {string}

Description:

  • 입력된 문자열 또는 날짜에 해당하는 월의 마지막 날의 일자를 계산한다.

Example
var origin = "19450815";
var last = $date.calcLastDateNum(origin);
	
var date = new Date();
var last2 = $date.calcLastDateNum(date);
Parameters:
Name Type Description
date string | Date

날짜를 계산하고자 하는 8자리 문자열 또는 날짜
Returns:

입력된 날짜가 포함된 달의 마지막 날짜(일자만 2자리)

Type
string

(static) checkDateRange(stDt, stTmopt, nullable, edDt, edTmopt, nullable) → {boolean}

Description:

  • 입력된 시작일시가, 종료일시 이전이 맞는지 확인한다.

    시작일 또는 종료일이 입력되지 않은 경우 무조건 true를 반환한다.

Example
var isValid = $date.checkDateRange('20230101','0530','20240101','2359');
Parameters:
Name Type Attributes Default Description
stDt string

시작일(8자리 문자열)
stTm string <optional>
<nullable>
 '0000'

시작시각(4자리 문자열)
edDt string

종료일(8자리 문자열)
edTm string <optional>
<nullable>
 '2359'

종료시각(4자리 문자열)
Returns:

시작일가 종료일시 이전인지 여부

Type
boolean

(static) diffDay(stdt, eddt) → {number}

Description:

  • 두 날짜 사이의 일 수 를 계산한다.

    비교종료일보다 비교시작일이 클 경우, 음수가 반환됩니다.

Example
var dateA = "19450815"
var dateB = "20000815"
var days = $date.diffDay(dateA,dateB);
Parameters:
Name Type Description
stdt string

비교시작일(숫자8자리)
eddt string

비교종료일(숫자8자리)
Returns:

두 날짜 사이의 일 수

Type
number

(static) diffMonth(stdt, eddt) → {Number}

Description:

  • 두 날짜 사이의 월 수 를 계산한다.

    비교종료일보다 비교시작일이 클 경우, 음수가 반환됩니다.

Example
var dateA = "19450815"
var dateB = "20000815"
var days = $date.diffMonth(dateA,dateB);
Parameters:
Name Type Description
stdt string

비교시작일(숫자8자리)
eddt string

비교종료일(숫자8자리)
Returns:

두 날짜 사이의 달 수

Type
Number

(static) format(date, formatStr, localeopt) → {string}

Description:

  • 입력된 날짜를 문자열로 만든다.

Example
var date = new Date();
var formattedDateStr = $date.format(date, "yyyy/mm/dd [day] am hh:mi:ss", 'ko-KR');
Parameters:
Name Type Attributes Description
date string | Date

윤년여부를 계산하고자 하는 8자리 문자열 또는 날짜
formatStr string

날짜 양식 문자열 날짜로 만들 때 사용하게 될 문자열입니다.

Date의 값이 1945년 8월 15일인 경우 "yyyy/mm/dd" > "1945/08/15" "yy년 mm월 dd일" > "45년 8월 15일" 등으로 문자열이 생성됩니다.

Properties
Name Type Description
yyyy string

연도(4자리)
yy string

연도(2자리)
mm string

월(2자리)
dd string

일(2자리)
day string

요일(한글)
am string

오전 오후 여부("AM/PM")
hh24 string

24시간 형식의 시간
hh string

12시간 형식의 시간
mi string

분(2자리)
ss string

초(2자리)
locale string <optional>

현재 locale (nexacro._locale)
Returns:

생성된 문자열

Type
string

(static) getDayNum(date) → {number}

Description:

  • 입력된 문자열의 날짜에 해당하는 요청을 구함

Example
var origin = "19450815";
var date = $date.getDayNum(date);
Parameters:
Name Type Description
date string | Date

요일을 계산하고자 하는 8자리 문자열 또는 날짜
Returns:

요일에 해당하는 숫자 0:일, 1:월, 2:화, 3:수, 4:목, 5:금, 6:토

Type
number

(static) getFirstDate(date) → {string}

Description:

  • 입력된 문자열 또는 날짜에 해당하는 월의 첫 날을 찾는다.

Example
var origin = "19450815";
var first = $date.getFirstDate(origin);
	
var date = new Date();
var first2 = $date.getFirstDate(date);
Parameters:
Name Type Description
date string | Date

날짜를 계산하고자 하는 8자리 문자열 또는 날짜
Returns:

입력된 날짜가 포함된 달의 첫 날짜(8자리)

Type
string

(static) getLastDate(date) → {string}

Description:

  • 입력된 문자열 또는 날짜에 해당하는 월의 마지막 날을 찾는다.

Example
var origin = "19450815";
var last = $date.getLastDate(origin);
	
var date = new Date();
var last2 = $date.getLastDate(date);
Parameters:
Name Type Description
date string | Date

날짜를 계산하고자 하는 8자리 문자열 또는 날짜
Returns:

입력된 날짜가 포함된 달의 마지막 날짜(8자리)

Type
string

(static) isLeapYear(date) → {boolean}

Description:

  • 입력된 문자열의 날짜가 윤년인지 확인

Example
var origin = "19450815";
var isLeap = $date.isLeapYear(date);
Parameters:
Name Type Description
date string | Date

윤년여부를 계산하고자 하는 8자리 문자열 또는 날짜
Returns:

윤년여부

Type
boolean

(static) isValid(str) → {boolean}

Description:

  • 입력된 문자열이 8자리 날짜 형식을 따르고 있는지 확인한다.

Example
var origin = "19450815";
var isValid = $date.isValid(origin);
Parameters:
Name Type Description
str string

날짜 형식 적합여부를 확인하고자 하는 문자열
Returns:

날짜 형식 양식 적합 여부

Type
boolean

(static) toDate(date, isUTC) → {Date}

Description:

  • 입력된 문자열의 날짜에 해당하는 Date객체를 생성합니다.

Example
var origin = "19450815";
var date = $date.toDate(date);
Parameters:
Name Type Description
date string | Date

요일을 계산하고자 하는 8자리 문자열 또는 날짜
isUTC boolean

세계시간기준여부
Returns:

해당 문자열의 날짜에 해당하는 Date객체

Type
Date