# 날짜 및 시간 함수

## 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` \- 그 해의 첫 번째 완전한 주\(일곱 개 요일이 모두 있는 주\)부터 시작

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

```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` \- 그 해의 첫 번째 완전한 주\(일곱 개 요일이 모두 있는 주\)부터 시작

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

```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")}
```

### Day

월의 날짜를 나타내는 1\~31(포함) 사이의 숫자를 반환합니다.
**구문**
Day(`date`)
**인수**

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

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

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

### Hour

하루 중 시간을 나타내는 0\~23(포함) 사이 숫자를 반환합니다.
**구문**
Hour(`date`)
**인수**

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

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

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

### Minute

시간 중 분을 나타내는 0\~59(포함) 사이 숫자를 반환합니다.
**구문**
Minute(`date`)
**인수**

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

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

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

### Month

연도의 월을 나타내는 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

현재 날짜 및 시간을 반환합니다.
**구문**
Now()

### Second

시간 중 초를 나타내는 0\~59(포함) 사이 숫자를 반환합니다.
**구문**
Second(`date`)
**인수**

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

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

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

### TimeOfDay

하루 중 현재 시간을 포함하는 날짜를 반환합니다.
**구문**
TimeOfDay()

### Timer

자정 이후 경과된 초를 반환합니다.
**구문**
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

자정에서 현재 날짜를 반환합니다.
**구문**
Today()

### Weekday

요일을 나타내는 숫자를 반환합니다.
**구문**
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)}
```

### Quarter

연도의 분기를 나타내는 1\~4(포함) 사이의 숫자를 반환합니다.
**구문**
Quarter(`date`)
**인수**

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

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

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

### QuarterName

분기 이름을 나타내는 문자열을 반환합니다.
**구문**
QuarterName(`date`)
**인수**

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

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

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

### Year

연도를 나타내는 숫자를 반환합니다.
**구문**
Year(`date`)
**인수**

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

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

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

### AddYears

호출 날짜에 지정된 연도 수를 더한 새 날짜를 반환합니다.
**구문**
.AddYears(`years`)
**인수**

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

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

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

### AddMonths

호출 날짜에 지정된 월수를 더한 새 날짜를 반환합니다.
**구문**
.AddMonths(`months`)
**인수**

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

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

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

### AddDays

호출 날짜에 지정된 일수를 더한 새 날짜를 반환합니다.
**구문**
.AddDays(`days`)
**인수**

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

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

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

### AddHours

호출 날짜에 지정된 시간 수를 더한 새 날짜를 반환합니다.
**구문**
.AddHours(`hours`)
**인수**

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

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

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

### AddMinutes

호출 날짜에 지정된 분 수를 더한 새 날짜를 반환합니다.
**구문**
.AddMinutes(`minutes`)
**인수**

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

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

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

### AddSeconds

호출 날짜에 지정된 초 수를 더한 새 날짜를 반환합니다.
**구문**
.AddSeconds(`seconds`)
**인수**

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

**예시**

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

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

### AddMilliseconds

호출 날짜에 지정된 밀리초 수를 더한 새 날짜를 반환합니다.
**구문**
.AddMilliseconds(`milliseconds`)
**인수**

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

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

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