dateUtil 개체는 파워씬의 내장 개체로 날짜/시간을 다룰때 사용합니다. Python의 기본 날짜/시간모듈인 datetime과 조합해 보다 쉽게 날짜 연산을 할수 있도록 기능을 지원 합니다.

Method

 dateUtil에서 제공하는 함수는 아래와 같습니다.


리턴 값

함 수

설 명

datetime

addHours(datetime , hours)

주어진 datetime에 시간을 더하거나 뺍니다.

datetime

addDays(datetime , day)

주어진 datetime에 일을 더하거나 뺍니다.

datetime

addMonths(datetime , month)

주어진 datetime에 월을 더하거나 뺍니다.

datetime

addYears(datetime , year)

주어진 datetime에 년을 더하거나 뺍니다.

datetime

alignToHour(datetime)

주어진 datetime의 값을 시 기준으로 초기화 합니다.

예) '2023-08-09 12:23:00' -> '2023-08-09 12:00:00'

datetime

alignToDay(datetime)

주어진 datetime의  값을 일 기준으로 초기화 합니다.

예) '2023-08-09 12:23:00' -> '2023-08-09 00:00:00'

datetime

alignToMonth(datetime )

주어진 datetime의  값을 월 기준으로 초기화 합니다.

예) '2023-08-09 12:23:00' -> '2023-08-01 00:00:00'

datetime

alignToYear(datetime)

주어진 datetime의 값을 년 기준으로 초기화 합니다.

예) '2023-08-09 12:23:00' -> '2023-01-01 00:00:00'

int

daysInMonth( year,month )

주어진 년,월의 일(Day) 수를 반환합니다.

datetime

now()

현재 시간을 반환 합니다. 파이썬의 datetime.datetime.now()와 동일한 기능 입니다.




 datetime addHours(datetime , hours)


 주어진 datetime에 시간을 더하거나 뺍니다.


  • datetime : Python DateTime 형식의 날짜/시간 값 입니다.
  • hour : 더하거나 뺄 시간 입니다. 값이 -인 경우 현재 시간에서 주어진 시간을 뺍니다.

 예)

#현재 시간을 읽습니다.

now = dateUtil.now()


#시 기준으로 초기화 합니다.

now=dateUtil.alignToHour(now);

print '기준 시간:' ,now

print '1시간 후:' ,dateUtil.addHours(now,1)

print '1시간 전:' ,dateUtil.addHours(now,-1)


결과)

>>>

기준 시간:  2023-08-17 15:00:00

1시간 후:  2023-08-17 16:00:00

1시간 전:  2023-08-17 14:00:00





 datetime addDays(datetime , days)


 주어진 datetime에 일을 더하거나 뺍니다.


  • datetime : Python DateTime 형식의 날짜/시간 값 입니다.
  • days : 더하거나 뺄 일 값입니다. 값이 -인 경우 현재 일에서 주어진 일을 뺍니다.

 예)

#현재 시간을 읽습니다.

now = dateUtil.now()


#일 기준으로 초기화 합니다.

now=dateUtil.alignToDay(now);

print '기준 시간:' ,now

print '1일 후:' ,dateUtil.addDays(now,1)

print '1일 전:' ,dateUtil.addDays(now,-1)


결과)

>>>

기준 시간:  2023-08-17 00:00:00

1일 후:    2023-08-18 00:00:00

1일 전:    2023-08-16 00:00:00




 datetime addMonths(datetime , months)


 주어진 datetime에 월을 더하거나 뺍니다.


  • datetime : Python DateTime 형식의 날짜/시간 값 입니다.
  • months : 더하거나 뺄 월 값입니다. 값이 -인 경우 현재 월에서 주어진 월을 뺍니다.

 예)

#현재 시간을 읽습니다.

now = dateUtil.now()


#월 기준으로 초기화 합니다.

now=dateUtil.alignToMonth(now);

print '기준 시간:' ,now

print '1개월 후:' ,dateUtil.addMonths(now,1)

print '1개월 전:' ,dateUtil.addMonths(now,-1)


결과)

>>>

기준 시간:  2023-08-01 00:00:00

1개월 후:  2023-09-01 00:00:00

1개월 전:  2023-07-01 00:00:00




 datetime addYears(datetime , years)


 주어진 datetime에 년을 더하거나 뺍니다.


  • datetime : Python DateTime 형식의 날짜/시간 값 입니다.
  • years : 더하거나 뺄 월 값입니다. 값이 -인 경우 현재 년도에서 주어진 년도를 뺍니다.

 예)

#현재 시간을 읽습니다.

now = dateUtil.now()


#년 기준으로 초기화 합니다.

now=dateUtil.alignToYear(now);

print '기준 시간:' ,now

print '1년 후:' ,dateUtil.addYears(now,1)

print '1년 전:' ,dateUtil.addYears(now,-1)


결과)

>>>

기준 시간:  2023-01-01 00:00:00

1년 후:    2024-01-01 00:00:00

1년 전:    2022-01-01 00:00:00




 datetime alignToHour(datetime)


 주어진 datetime의 값을 시 기준으로 초기화 합니다.


  • datetime : Python DateTime 형식의 날짜/시간 값 입니다.

 예)

#현재 시간을 읽습니다.

now = dateUtil.now()


#시 기준으로 초기화 합니다.

print 'Now    : ' ,now

print 'Aligned: ' ,dateUtil.alignToHour(now)


결과)

>>>

Now    : 2023-08-17 16:03:03

Aligned: 2023-08-17 16:00:00




 datetime alignToDay(datetime)


 주어진 datetime의 값을 일 기준으로 초기화 합니다.


  • datetime : Python DateTime 형식의 날짜/시간 값 입니다.

 예)

#현재 시간을 읽습니다.

now = dateUtil.now()


#일 기준으로 초기화 합니다.

print 'Now    : ' ,now

print 'Aligned: ' ,dateUtil.alignToDay(now)


결과)

>>>

Now    : 2023-08-17 16:03:03

Aligned: 2023-08-17 00:00:00




 datetime alignToDay(datetime)


 주어진 datetime의 값을 일 기준으로 초기화 합니다.


  • datetime : Python DateTime 형식의 날짜/시간 값 입니다.

 예)

#현재 시간을 읽습니다.

now = dateUtil.now()


#일 기준으로 초기화 합니다.

print 'Now    : ' ,now

print 'Aligned: ' ,dateUtil.alignToDay(now)


결과)

>>>

Now    : 2023-08-17 16:03:03

Aligned: 2023-08-17 00:00:00





 datetime alignToMonth(datetime)


 주어진 datetime의 값을 월 기준으로 초기화 합니다.


  • datetime : Python DateTime 형식의 날짜/시간 값 입니다.

 예)

#현재 시간을 읽습니다.

now = dateUtil.now()


#월 기준으로 초기화 합니다.

print 'Now    : ' ,now

print 'Aligned: ' ,dateUtil.alignToMonth(now)


결과)

>>>

Now    : 2023-08-17 16:03:03

Aligned: 2023-08-01 00:00:00





 datetime alignToYear(datetime)


 주어진 datetime의 값을 년 기준으로 초기화 합니다.


  • datetime : Python DateTime 형식의 날짜/시간 값 입니다.

 예)

#현재 시간을 읽습니다.

now = dateUtil.now()


#년 기준으로 초기화 합니다.

print 'Now    : ' ,now

print 'Aligned: ' ,dateUtil.alignToYear(now)


결과)

>>>

Now    : 2023-08-17 16:03:03

Aligned: 2023-01-01 00:00:00





 int daysInMonth(year,month)


 주어진 년,월의 일(Day) 수를 반환합니다.

  • year : 년 입니다.
  • month: 월 입니다.

 예)

print dateUtil.daysInMonth(2023,2)

print dateUtil.daysInMonth(2024,2)

print dateUtil.daysInMonth(2025,2)

print dateUtil.daysInMonth(2026,2)


결과)

>>>

28

29

28

28





 datetime now()


 현재 시간을 반환 합니다. 파이썬의 datetime.datetime.now()와 동일한 기능 입니다


 예)

print dateUtil.now()


결과)

>>>

2023-08-17 16:15:19