Type

engine

Property Summary

Event Summary

Method Summary

dateAdd( day1 , offset )

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

dateDiff( day1 , day2 )

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

dateTimeAdd( day1 , offset , type )

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

getCurrentServerDate( pattern )

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

getDay( dateFormatStr )

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

getFormattedDate( dateObj , pattern )

Date객체를 받아서 지정된 format으로 시간을 반환합니다.

getIOFormatDate( value , ioFormat , calendarValueType )

날짜 값과 ioFormat 그리고 calendarValueType을 입력 받아서

getIOUnFormatDate( value , ioFormat , calendarValueType )

날짜 값과 ioFormat 그리고 calendarValueType을 입력 받아서 각각의 calendarValueType에 맞는

getMaxMinYear( )

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

isValidDate( obj , sDate )

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

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 )

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

Parameter

name	type	required	description
day1	String	Y	시작 날짜
day2	String	Y	끝 날짜

Return

type	description
String	두 날짜의 차이

Sample

var diff = WebSquare.date.dateDiff( "20120120", "20120210" ); diff : 21

dateTimeAdd( day1 , offset , type )

날짜 및 시간에 지정된 수만큼 더합니다.( date + offset )
type에서 설정한 값(day,month,hour,minute,time)에 따라서
증가되는 대상이 달라집니다.

Parameter

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

Return

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

Sample

var addTimeDate = WebSquare.date.dateTimeAdd( 20120102, 7 ); addDate : 20120109

getCurrentServerDate( pattern )

서버의 현재 시간을 반환합니다.
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 )

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을 입력하지 않는 경우에는 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 dateStr = WebSquare.date.getFormattedDate ( dateObj, “yyyy.MM” ); dateStr : 2011.12

getIOFormatDate( value , ioFormat , calendarValueType )

날짜 값과 ioFormat 그리고 calendarValueType을 입력 받아서
파라미터로 전달 받은 ioFormat에 맞는 순서로 날짜 값을 반환하는 함수.
관련 속성으로 inputCalendar컴포넌트의 useYearMonthFormat이 있다.

Parameter

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

Return

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

Sample

inputCalendar 컴포넌트에 다음의 설정 값들이 추가되어 있다. 이 때 getIOFormatDate함수 실행 시 ioFormat에 맞는 날짜 값이 반환된다. ioFormat = "MMyyyy" calendarValueType = "yearMonth" var ioFormatDate = WebSquare.date.getIOFormatDate ( "201701", "MMyyyy", “yearMonth” ); ioFormatDate : 012017

getIOUnFormatDate( value , ioFormat , calendarValueType )

날짜 값과 ioFormat 그리고 calendarValueType을 입력 받아서 각각의 calendarValueType에 맞는
ioFormat 형식으로된 날짜 값을 한국식 표기 방식인 "연" > "월" > "일" > "시간" 순으로 재배열해주는 함수. 관련 속성으로 inputCalendar컴포넌트의 useMonthYearFormat이 있다.

Parameter

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

Return

type	description
String	날짜 값을 한국식 표기 방식인 "연" > "월" > "일" > "시간" 순으로 재배열해서 값을 반환한다.

Sample

inputCalendar 컴포넌트에 다음의 설정 값들이 추가되어 있다. 이 때 getIOUnFormatDate 실행 시 한국식 날짜 표기 방식에 맞는 날짜 값이 반환된다. ioFormat = "MMyyyy" calendarValueType = "yearMonth" var ioFormatDate = WebSquare.date.getIOFormatDate ( "012017", "MMyyyy", “yearMonth” ); ioFormatDate : 201701

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 )

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

Parameter

name	type	required	description
obj	Object	Y	websquare 객체
sDate	String	Y	검증 대상 날짜

Return

type	description
Boolean	유효한 날짜면 true, 아니면 false

Sample

var validYn = WebSquare.date.isValidDate (input1, input1.getValue()); validYn : input1.getValue()의 값이 유효하지 않는 날짜이면 false, 유효하면 true.

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.fffffffff을 반환합니다.

Parameter

name	type	required	description
dateObj	Object	Y	JavaScript date객체

Return

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

Sample

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