Type

engine

Property Summary

Event Summary

Method Summary

dateAdd( day1 , offset )

날짜에 지정된 수만큼 더합니다

dateDiff( day1 , day2 , options )

두 날짜 사이의 차이를 반환합니다

dateTimeAdd( day1 , offset , type )

날짜 및 시간에 지정된 수만큼 더합니다.( date + offset )

getCurrentServerDate( pattern , msaName )

서버의 현재 시간을 반환합니다.

getDay( dateFormatStr )

"yyyyMMdd" 형태의 날짜를 입력받아서 해당 요일을 반환합니다

getFormattedDate( dateObj , pattern )

Date객체 또는 문자열을 받아서 지정된 format으로 시간을 반환합니다.

getIOFormatDate( value , ioFormat )

날짜값, ioFormat을 입력 받아서 ioFormat에 맞게 날짜 값을 반환하는 함수

getIOUnFormatDate( value , ioFormat )

날짜값, ioFormat을 입력받아 날짜값을 "yyyyMMddHHmmss" 형식으로 치환한다

getMaxMinYear( )

maxYear 와 minYear 프로퍼티를 포함한 오브젝트를 반환합니다

isValidDate( obj , sDate , options )

"yyyyMMdd" 형태의 날짜값을 받아서 유효한 날짜인지를 확인하여 boolean 또는 JSON을 반환합니다

parseDate( str , format )

날짜 형식 포맷을 Date로 변환합니다

toLunar( solar )

"yyyyMMdd" 형태의 양력 날짜를 입력으로 받아 해당하는 음력 날짜의 string을 반환한다.

toSolar( solar )

"yyyyMMdd" 형태의 음력 날짜를 입력으로 받아 해당하는 양력 날짜의 string을 반환한다.

toTimestampString( dateObj )

java

dateAdd( day1 , offset )

날짜에 지정된 수만큼 더합니다.( date + offset )

Parameter

name	type	required	description
day1	String	Y	지정 날짜
offset	Number	Y	날짜에 더할 숫자

Return

type	description
String	지정된 수 많큼 더해진 날짜

Sample

var addDate = WebSquare.date.dateAdd( "20120102", 7 ); //addDate : 20120109

dateDiff( day1 , day2 , options )

두 날짜 사이의 차이를 반환합니다.( to - from )

Parameter

name	type	required	description
day1	String	Y	시작 날짜
day2	String	Y	끝 날짜
options	Object	Y	JSON 형태로 저장된 옵션 <String:N> options.returnType : [default: day] 반환 유형을 지정 (day: 일수 차이, month: 개월 수 차이)

Return

type	description
String	두 날짜의 차이

Sample

var diff1 = WebSquare.date.dateDiff( "20120120", "20120210" ); //diff1 : 21 var diff2 = WebSquare.date.dateDiff( "20230101", "20230120", {"returnType" : "month"} ); //diff2 : 0 var diff3 = WebSquare.date.dateDiff( "20230131", "20230201", {"returnType" : "month"} ); //diff3 : 1 var diff4 = WebSquare.date.dateDiff( "20230101", "20240101", {"returnType" : "month"} ); //diff4 : 12

dateTimeAdd( day1 , offset , type )

날짜 및 시간에 지정된 수만큼 더합니다.( date + offset )
type에서 설정한 값(day,month,hour,minute,time)에 따라서 증가되는 대상이 달라진다.
type이 day일 경우엔 첫번째 인자의 날짜 형식이 yyyyMMdd, month일 경우 yyyyMM, hour일 경우 yyyMMddHH, minute일 경우 yyyyMMddHHmm 형식이어야 한다.

Parameter

name	type	required	description
day1	String	Y	지정 날짜와 시간
offset	Number	Y	날짜에 더할 숫자
type	String	Y	증가된 값이 적용될 대상(day, month, hour, minute )

Return

type	description
String	지정된 수 많큼 더해진 날짜

Sample

var addTimeDateD = WebSquare.date.dateTimeAdd( "20120102", 7, "day" ); //addDate : 20120109 var addTimeDateM = WebSquare.date.dateTimeAdd( "201201", 7, "month" ); //addDate : 201208 var addTimeDateH = WebSquare.date.dateTimeAdd( "2012010213", 7, "hour" ); //addDate : 2012010220 var addTimeDatem = WebSquare.date.dateTimeAdd( "201201021310", 7, "minute" ); //addDate : 201201021317

getCurrentServerDate( pattern , msaName )

서버의 현재 시간을 반환합니다.
Java의 SimpleDateFormat의 pattern을 인자로 받아서 시간을 표현합니다.
pattern을 입력하지 않는 경우에는 yyyyMMdd 패턴의 결과를 반환합니다.
y Year 1996; 96
M Month in year 07
d Day in month 10
H Hour in day (0-23) 0
m Minute in hour 30
s Second in minute 55
S Millisecond 978

Parameter

name	type	required	description
pattern	String	N	날짜 형식( ex) yyyyMMdd )
msaName	String	N	MSA서버명

Return

type	description
String	서버 날짜(시간) String

Sample

var dateStr = WebSquare.date.getCurrentServerDate(); //dateStr : 20111225 (yyyyMMdd) var dateStr = WebSquare.date.getCurrentServerDate("yyyyMMddHHmmssSSS") //dateStr : 20111225112433707 (yyyyMMddHHmmssSSS)

getDay( dateFormatStr )

"yyyyMMdd" 형태의 날짜를 입력받아서 해당 요일을 반환합니다. (예를 들어 '월요일' 등의 string을 반환)

Parameter

name	type	required	description
dateFormatStr	String	Y	"yyyyMMdd" 형태의 날짜를 나타내는 string

Return

type	description
String	'월요일' 등의 요일을 나타내는 string

Sample

var day = WebSquare.date.getDay("20111225"); //day : 일요일

getFormattedDate( dateObj , pattern )

Date객체 또는 문자열을 받아서 지정된 format으로 시간을 반환합니다.
문자열을 입력받은 경우, 문자열의 날짜 형식과 pattern의 날짜 형식이 일치해야 합니다.
WebSquare.date.getFormattedDate ( "20230101" , "yyyy.MM.dd" ); // 일치
WebSquare.date.getFormattedDate ( "20230101" , "yy.MM.dd" ); // 불일치
pattern을 입력하지 않는 경우에는 java의 System.currentTimeMillis()값을 반환합니다.

Parameter

name	type	required	description
dateObj	Object	Y	JavaScript date객체 또는 문자열
pattern	String	N	패턴

Return

type	description
String	지정된 format으로 시간을 반환 Letter Date or Time Component Examples y Year 1996; 96 M Month in year 07 d Day in month 10 H Hour in day (0-23) 0 m Minute in hour 30 s Second in minute 55 S Millisecond 978

Sample

var dateObj = new Date(); var dateStr1 = WebSquare.date.getFormattedDate ( dateObj, "yyyy.MM" ); //dateStr1 : 2011.12 var dateStr2 = WebSquare.date.getFormattedDate ( "20230101" , "yyyy.MM.dd" ); //dateStr2 : 2023.01.01

getIOFormatDate( value , ioFormat )

날짜값, ioFormat을 입력 받아서 ioFormat에 맞게 날짜 값을 반환하는 함수.

Parameter

name	type	required	description
value	String	Y	변환할 날짜 값
ioFormat	String	Y	날짜 값에 적용할 ioFormat 값

Return

type	description
String	지정된 ioFormat으로 날짜 값을 반환

Sample

var ioFormatDate1 = WebSquare.date.getIOFormatDate ( "201701", "MMyyyy"); // ioFormatDate1 : 012017 var ioFormatDate2 = WebSquare.date.getIOFormatDate ( "20170103", "MMddyyyy"); // ioFormatDate2 : 01032017 var ioFormatDate3 = WebSquare.date.getIOFormatDate ( "20170103112014", "ddMMyyyyHHmmss"); // ioFormatDate3 : 03012017112014

getIOUnFormatDate( value , ioFormat )

날짜값, ioFormat을 입력받아 날짜값을 "yyyyMMddHHmmss" 형식으로 치환한다.

Parameter

name	type	required	description
value	String	Y	변환할 날짜 값
ioFormat	String	Y	현재 날짜 값에 적용되어 있는 ioFormat 값

Return

type	description
String	"yyyyMMddHHmmss" 형식으로 치환된 날짜값

Sample

var ioUnformatDate1 = WebSquare.date.getIOUnFormatDate ( "012017", "MMyyyy"); // ioFormatDate1 : 201701 var ioUnformatDate2 = WebSquare.date.getIOUnFormatDate ( "25012017", "ddMMyyyy"); // ioFormatDate2 : 20170125 var ioUnformatDate3 = WebSquare.date.getIOUnFormatDate ( "01252017142055", "MMddyyyyHHmmss"); // ioFormatDate3 : 20170125142005

getMaxMinYear( )

maxYear 와 minYear 프로퍼티를 포함한 오브젝트를 반환합니다. config.xml에 정의된 값이 기본값으로 사용됩니다. (아래 Sample 참조.)

Return

type	description
Object	maxYear, minYear

Sample

//config.xml 에서 아래와 같이 정의된 설정값을 기본값으로 합니다. <websquare> <date> <maxYear value="2099" /> <minYear value="1000" /> </date> </websquare> var maxMinYear = WebSquare.date.getMaxMinYear(); //maxMinYear[ "maxYear" ] : 2099 (yyyy) //maxMinYear[ "minYear" ] : 1000 (yyyy)

isValidDate( obj , sDate , options )

"yyyyMMdd" 형태의 날짜값을 받아서 유효한 날짜인지를 확인하여 boolean 또는 JSON을 반환합니다. 유효하지 않은 날짜라면 obj에 포커스를 줍니다.

Parameter

name	type	required	description
obj	Object	Y	websquare 객체
sDate	String	Y	검증 대상 날짜
options	Object	N	JSON 형태로 저장된 옵션 <String:N> options.useAlert : [default: "true"] alert을 보여줄지 지정 <String:N> options.returnType : [default: "boolean"] 유효한지 결과를 boolean으로 보여줄지, JSON으로 보여줄지 지정

Return

type	description
Boolean||JSON	Boolean이면 유효한 날짜면 true, 아니면 false, JSON이면 유효하면 {"result" : true}, 유효하지 않으면 { "result": false, message: message}

Sample

options.useAlert이 "true"이면 alert을 보여주고, "false"이면 alert이 보이지 않습니다. options.returnType이 "boolean"이면 유효하면 true, 유효하지 않는 날짜이면 false를 반환 options.returnType이 "json"이면 유효하면 {"result" : true}, 유효하지 않으면 { "result": false, message: 해당 메세지}를 반환 var options = { useAlert : "true", returnType : "json" } var result = WebSquare.date.isValidDate (inputCalendar1, inputCalendar1.getValue(), options); result : {result: false, message: '입력값은 yyyyMMdd형식이어야 합니다. 입력값 : 345345'}

parseDate( str , format )

날짜 형식 포맷을 Date로 변환합니다. (기본 포맷 : yyyyMMdd)

Parameter

name	type	required	description
str	String	Y	년월일 String
format	String	N	날짜형식 포맷

Return

type	description
Object	날짜 포맷을 Date 객체로 파싱한 js의 date 오브젝트

Sample

var dateObj = WebSquare.date.parseDate ("20120101"); alert(dateObj.toString()); //결과 : Sun Jan 1 00:00:00 UTC+0900 2012 var dateObj = WebSquare.date.parseDate ("01222013112430", "MMddyyyyHHmmss"); alert(dateObj.toString()); //결과 : Tue Jan 22 2013 11:24:30 GMT+0900 (KST)

toLunar( solar )

"yyyyMMdd" 형태의 양력 날짜를 입력으로 받아 해당하는 음력 날짜의 string을 반환한다.
1000년 02월 13일 부터 2050년 12월 31일까지 지원한다.
변환 범위를 벗어나거나 잘못된 형식의 값을 입력하면 오류 로그가 출력되고 undefined를 반환한다.

Parameter

name	type	required	description
solar	String	Y	"yyyyMMdd" 형태의 양력 날짜

Return

type	description
String	음력날짜를 나타내는 string

Sample

var lunar = WebSquare.date.toLunar("20111225"); //lunar : 20111201

toSolar( solar )

"yyyyMMdd" 형태의 음력 날짜를 입력으로 받아 해당하는 양력 날짜의 string을 반환한다.
1000년 01월 01일 부터 2050년 11월 18일까지 지원한다.
변환 범위를 벗어나거나 잘못된 형식의 값을 입력하면 오류 로그가 출력되고 undefined를 반환한다.

Parameter

name	type	required	description
solar	String	Y	"yyyyMMdd" 형태의 음력 날짜

Return

type	description
String	양력날짜를 나타내는 string

Sample

var solar = WebSquare.date.toLunar("20221025"); // solar : 20221118

toTimestampString( dateObj )

java.sql.Timestamp에서 사용되는 yyyy-mm-dd hh:mm:ss.ffffff을 반환합니다.

Parameter

name	type	required	description
dateObj	Object	Y	JavaScript date객체

Return

type	description
String	yyyy-mm-dd hh:mm:ss.ffffff 형식의 string

Sample

var dateObj = new Date(); var dateStr = WebSquare.date.toTimestampString (dateObj); //dateStr : 2011-12-25 11:01:47.219000