# 날짜 및 시간 함수

## Content




### DateAdd

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

**구문** 

DateAdd(```interval```, ```number```, ```date```)

**인수**

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

**예시**

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

```js
{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요일이 모두 있는 첫 번째 전체 주로 시작합니다.

**예시**

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

```js
{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요일이 모두 있는 첫 번째 전체 주로 시작합니다.

**예시**

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

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

### DateSerial

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

**구문**

DateSerial(```year```, ```month```, ```day```)

**인수**

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


**예시**

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

```js
{DateSerial(1982, 1, 4)}
```

### DateString

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

**구문**

DateString()

### DateValue

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

**구문**

DateValue(```date```)

**인수**

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

**예시**

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

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

### 일

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

**구문**

Day(```date```)

**인수**

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

**예시**

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

```js
{Day(Now())}
```

### 시

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

**구문**

Hour(```date```)

**인수**

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

**예시**

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

```js
{Hour(Now())}
```

### 분

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

**구문**

Minute(```date```)

**인수**

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

**예시**

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

```js
{Minute(Now())}
```

### 월

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

**구문**

Month(```date```)

**인수**

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

**예시**

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

```js
{Month(Now())}
```

### MonthName

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

**구문**

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

**인수**

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

**예시**

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

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

### 지금

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

**구문**

Now()

### 초

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

**구문**

Second(```date```)

**인수**

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

**예시**

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

```js
{Second(Now())}
```

### TimeOfDay

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

**구문**

TimeOfDay()

### 타이머

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

**구문**

Timer()

### TimeSerial

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

**구문**

TimeSerial(```hour```, ```minute```, ```second```)


**인수**

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

**예시**

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

```js
{TimeSerial(15, 30,0)}
```

### TimeString

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

**구문**

TimeString()

### TimeValue

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

**구문**

TimeValue(```time```)

**인수**

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

**예시**

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

```js
{TimeValue("3:15am")}
```

### 오늘

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

**구문**

Today()


### 주중

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

**구문**

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

**인수**

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

**예시**

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

```js
{Weekday(Today())}
```

### WeekDayName

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

**구문**

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

**인수**

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

**예시**

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

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

### 분기

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

**구문**

Quarter(```date```)

**인수**

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

**예시**

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

```js
{Quarter(Now())}
```

### QuarterName

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

**구문**

QuarterName(```date```)

**인수**

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

**예시**

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

```js
{QuarterName(Now())}
```

### 년

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

**구문**

Year(```date```)

**인수**

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

**예시**

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

```js
{Year(Now())}
```

### AddYears

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

**구문**

<Date>.AddYears(```years```)

**인수**

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

**예시**

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

```js
{Now().AddYears(2)}
```

### AddMonths

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

**구문**

<Date>.AddMonths(```months```)

**인수**

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

**예시**

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

```js
{Now().AddMonths(-5)}
```

### AddDays

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

**구문**

<Date>.AddMonths(```days```)

**인수**

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

**예시**

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

```js
{Now().AddDays(1)}
```

### AddHours

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

**구문**

<Date>.AddHours(```hours```)

**인수**

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

**예시**

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

```js
{Now().AddHours(-24)}
```

### AddMinutes

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

**구문**

<Date>.AddMinutes(```minutes```)

**인수**

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

**예시**

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

```js
{Now().AddMinutes(-30)}
```

### AddSeconds

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

**구문**

<Date>.AddSeconds(```seconds```)

**인수**

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

**예시**

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

```js
{Now().AddSeconds(45)}
```

### AddMilliseconds

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

**구문**

<Date>.AddMilliseconds(```milliseconds```)

**인수**

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

**예시**

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

```js
{Now().AddMilliseconds(-654)}
```