날짜 및 시간 함수

DateAdd

지정된 시간 간격이 추가된 날짜를 반환합니다.

구문

DateAdd(interval, number, date)

인수

interval은 추가하려는 시간 간격을 설정하는 문자열입니다. 가능한 값은 다음과 같습니다.
- yyyy - 연도
- q - 분기
- m - 월
- y - 일자
- d - 일
- w - 요일
- ww - 주
- h - 시간
- n - 분
- s - 초
number는 추가하려는 간격을 나타내는 숫자입니다. 양수(미래의 날짜를 가져옴) 또는 음수(과거의 날짜를 가져옴)일 수 있습니다.
date는 간격이 추가되는 날짜입니다.

예시

현재 날짜에 1년을 더하기 위해 다음 식을 사용할 수 있습니다.

{DateAdd("yyyy", 1, Now())}

DateDiff

지정된 두 날짜 사이의 시간 간격을 반환합니다.

구문

DateDiff(interval, date1, date2, [ firstdayofweek, [ ```firstweekofyear``` ]] )

인수

interval은 date1과 date2 간 차이를 계산하기 위해 사용하는 시간 간격을 설정하는 문자열입니다. 가능한 값은 다음과 같습니다.
- yyyy - 연도
- q - 분기
- m - 월
- y - 일자
- d - 일
- w - 요일
- ww - 주
- h - 시간
- n - 분
- s - 초
date1, date2 - 계산에서 사용할 날짜 2개입니다.
firstdayofweek는 주의 첫 번째 요일을 지정하는 선택적 숫자입니다(일요일=1, 토요일=7). 지정하지 않은 경우에는 일요일이라고 가정합니다.
firstweekofyear는 해당 연도의 첫째 주를 지정하는 선택적 숫자입니다. 지정하지 않은 경우에는 1월 1일이 있는 주가 첫 번째 주라고 가정합니다. 가능한 값은 다음과 같습니다.
- 1 - 1월 1일이 있는 주로 시작합니다.
- 2 - 새해의 마지막 4일이 있는 첫 번째 주로 시작합니다.
- 3 - 해당 연도에서 7요일이 모두 있는 첫 번째 전체 주로 시작합니다.

예시

주문 후 배송하는 데 걸리는 시간을 비교하려면 다음 식을 사용할 수 있습니다.

{DateDiff("d", ShipDate, OrderDate)}

DatePart

주어진 날짜의 지정된 일부분을 반환합니다.

구문

DatePart(interval, date, [ firstdayofweek, [ ```firstweekofyear``` ]])

인수

interval은 반환하려는 시간 간격을 설정하는 문자열입니다. 가능한 값은 다음과 같습니다.
- yyyy - 연도
- q - 분기
- m - 월
- y - 일자
- d - 일
- w - 요일
- ww - 주
- h - 시간
- n - 분
- s - 초
date - 일부분을 반환하려는 날짜입니다.
firstdayofweek는 주의 첫 번째 요일을 지정하는 선택적 숫자입니다(일요일=1, 토요일=7). 지정하지 않은 경우에는 일요일이라고 가정합니다.
firstweekofyear는 해당 연도의 첫째 주를 지정하는 선택적 숫자입니다. 지정하지 않은 경우에는 1월 1일이 있는 주가 첫 번째 주라고 가정합니다. 가능한 값은 다음과 같습니다.
- 1 - 1월 1일이 있는 주로 시작합니다.
- 2 - 새해의 마지막 4일이 있는 첫 번째 주로 시작합니다.
- 3 - 해당 연도에서 7요일이 모두 있는 첫 번째 전체 주로 시작합니다.

예시

다음 식을 사용하여 현재 연도와 함께 저작권 기호를 표시할 수 있습니다.

© {DatePart("yyyy", Now())}

DateSerial

지정된 연도, 월 및 날짜를 반환합니다.

구문

DateSerial(year, month, day)

인수

year - 100~9999 사이의 정수
month - 1~12 사이의 정수
day - 1~31 사이의 정수

예시

다음 식을 사용하여 1982년 1월 4일을 구성할 수 있습니다.

{DateSerial(1982, 1, 4)}

DateString

현재 날짜를 yyyy-mm-dd 서식으로 나타내는 문자열을 반환합니다.

구문

DateString()

DateValue

지정한 문자열에서 날짜를 반환합니다.

구문

DateValue(date)

인수

date - yyyy-mm-dd 서식의 날짜를 포함한 문자열

예시

다음 식을 사용하여 2020-02-29 문자열에서 날짜를 구성할 수 있습니다.

{DateValue("2020-02-29")}

일

월의 날짜를 나타내는 1~31(포함) 사이의 숫자를 반환합니다.

구문

Day(date)

인수

date - 월의 날짜를 반환하려는 일자

예시

다음 식을 사용하여 현재 일자에 해당하는 날짜를 반환할 수 있습니다.

{Day(Now())}

시

하루 중 시간을 나타내는 0~23(포함) 사이 숫자를 반환합니다.

구문

Hour(date)

인수

date - 하루 중 시간을 반환하려는 날짜

예시

다음 식을 사용하여 현재 날짜의 하루 중 시간을 반환할 수 있습니다.

{Hour(Now())}

분

시간 중 분을 나타내는 0~59(포함) 사이 숫자를 반환합니다.

구문

Minute(date)

인수

date - 시간의 분을 반환하려는 날짜

예시

다음 식을 사용하여 현재 날짜의 시간 중 분을 반환할 수 있습니다.

{Minute(Now())}

월

연도의 월을 나타내는 1~12(포함) 사이의 숫자를 반환합니다.

구문

Month(date)

인수

date - 연도의 월을 반환하려는 날짜

예시

다음 식을 사용하여 현재 날짜의 연도 중 월을 반환할 수 있습니다.

{Month(Now())}

MonthName

지정된 월을 나타내는 문자열을 반환합니다.

구문

MonthName(month, [ ```abbreviate``` ])

인수

month - 숫자로 지정된 월입니다. 예를 들어, 1월은 1, 2월은 2와 같은 식입니다.
abbreviate - 월 이름을 약어로 표시해야 할지 나타내는 선택적 부울 값입니다. 기본값은 false입니다.

예시

다음 식을 사용하여 현재 월의 약어를 반환할 수 있습니다.

{MonthName(Month(Now()), true)}

지금

현재 날짜 및 시간을 반환합니다.

구문

Now()

초

시간 중 초를 나타내는 0~59(포함) 사이 숫자를 반환합니다.

구문

Second(date)

인수

date - 분의 초를 반환하려는 날짜

예시

다음 식을 사용하여 현재 날짜의 분 중 초를 반환할 수 있습니다.

{Second(Now())}

TimeOfDay

하루 중 현재 시간을 포함하는 날짜를 반환합니다.

구문

TimeOfDay()

타이머

자정 이후 경과된 초를 반환합니다.

구문

Timer()

TimeSerial

특정 시간, 분 및 초에 해당하는 시간이 포함된 날짜를 반환합니다.

구문

TimeSerial(hour, minute, second)

인수

hour - 0~23 사이의 정수
minute - 0~59 사이의 정수
second - 0~59 사이의 정수

예시

다음 식을 사용하여 3:30 pm 시간에서 날짜를 구성할 수 있습니다.

{TimeSerial(15, 30,0)}

TimeString

하루 중 현재 시간을 나타내는 문자열 값을 반환합니다.

구문

TimeString()

TimeValue

지정한 문자열에서 날짜 값을 반환합니다.

구문

TimeValue(time)

인수

time - 12시간 또는 24시간 시계에 해당하는 시간 값을 포함한 문자열

예시

다음 식을 사용하여 3:15 am 문자열에서 날짜를 구성할 수 있습니다.

{TimeValue("3:15am")}

오늘

자정에서 현재 날짜를 반환합니다.

구문

Today()

주중

요일을 나타내는 숫자를 반환합니다.

구문

Weekday(date, [ ```firstdayofweek``` ])

인수

date - 요일을 반환하려는 날짜
firstdayofweek는 주의 첫 번째 요일을 지정하는 선택적 숫자입니다(일요일=1, 토요일=7). 지정하지 않은 경우에는 일요일이라고 가정합니다.

예시

다음 식을 사용하여 현재 요일을 반환할 수 있습니다.

{Weekday(Today())}

WeekDayName

지정된 요일을 나타내는 문자열을 반환합니다.

구문

WeekdayName(weekday, [abbreviate, [```firstdayofweek``` ]])

인수

weekday - 요일에 대한 숫자 지정입니다. 각 요일의 숫자 값은 firstdayofweek 인수의 설정에 따라 달라집니다.
abbreviate - 요일 이름을 약어로 표시해야 할지 나타내는 선택적 부울 값입니다. 기본값은 false입니다.
firstdayofweek는 주의 첫 번째 요일을 지정하는 선택적 숫자입니다(일요일=1, 토요일=7). 지정하지 않은 경우에는 일요일이라고 가정합니다.

예시

다음 식을 사용하여 요일의 약어를 반환할 수 있습니다.

{WeekDayName(Weekday(Now()), true)}

분기

연도의 분기를 나타내는 1~4(포함) 사이의 숫자를 반환합니다.

구문

Quarter(date)

인수

date - 연도의 분기를 반환하려는 날짜

예시

다음 식을 사용하여 현재 날짜의 연도 중 분기를 반환할 수 있습니다.

{Quarter(Now())}

QuarterName

분기 이름을 나타내는 문자열을 반환합니다.

구문

QuarterName(date)

인수

date - 분기 이름을 반환하려는 날짜

예시

다음 식을 사용하여 현재 날짜의 분기 이름을 반환할 수 있습니다.

{QuarterName(Now())}

년

연도를 나타내는 숫자를 반환합니다.

구문

Year(date)

인수

date - 연도를 반환하려는 날짜

예시

다음 식을 사용하여 현재 연도를 반환할 수 있습니다.

{Year(Now())}

AddYears

호출 날짜에 지정된 연도 수를 더한 새 날짜를 반환합니다.

구문

.AddYears(years)

인수

years - 더할 연수. 음수 또는 양수일 수 있습니다.

예시

다음 식을 사용하여 현재 날짜에서 2년 앞선 날짜를 반환할 수 있습니다.

{Now().AddYears(2)}

AddMonths

호출 날짜에 지정된 월수를 더한 새 날짜를 반환합니다.

구문

.AddMonths(months)

인수

months - 더할 개월 수. 음수 또는 양수일 수 있습니다.

예시

다음 식을 사용하여 현재 날짜에서 5개월 이전 날짜를 반환할 수 있습니다.

{Now().AddMonths(-5)}

AddDays

호출 날짜에 지정된 일수를 더한 새 날짜를 반환합니다.

구문

.AddMonths(days)

인수

days - 더할 일수. 음수 또는 양수일 수 있습니다.

예시

다음 식을 사용하여 내일의 날짜를 반환할 수 있습니다.

{Now().AddDays(1)}

AddHours

호출 날짜에 지정된 시간 수를 더한 새 날짜를 반환합니다.

구문

.AddHours(hours)

인수

hours - 더할 시간 수. 음수 또는 양수일 수 있습니다.

예시

다음 식을 사용하여 어제의 날짜를 반환할 수 있습니다.

{Now().AddHours(-24)}

AddMinutes

호출 날짜에 지정된 분 수를 더한 새 날짜를 반환합니다.

구문

.AddMinutes(minutes)

인수

minutes - 더할 분 수. 음수 또는 양수일 수 있습니다.

예시

다음 식을 사용하여 현재 날짜에서 30분 이전 날짜를 반환할 수 있습니다.

{Now().AddMinutes(-30)}

AddSeconds

호출 날짜에 지정된 초 수를 더한 새 날짜를 반환합니다.

구문

.AddSeconds(seconds)

인수

seconds - 더할 초 수. 음수 또는 양수일 수 있습니다.

예시

다음 식을 사용하여 현재 날짜에서 45초 앞선 날짜를 반환할 수 있습니다.

{Now().AddSeconds(45)}

AddMilliseconds

호출 날짜에 지정된 밀리초 수를 더한 새 날짜를 반환합니다.

구문

.AddMilliseconds(milliseconds)

인수

milliseconds - 더할 밀리초 수. 음수 또는 양수일 수 있습니다.

예시

다음 식을 사용하여 현재 날짜에서 654밀리초 이전 날짜를 반환할 수 있습니다.

{Now().AddMilliseconds(-654)}