이 함수는 스크립트를 마지막으로 로드한 날짜의 연도 내에 입력 날짜가 포함되는지 파악하고, 포함되는 경우 True, 포함되지 않는 경우 False를 반환합니다.
구문:
YearToDate(timestamp [ , yearoffset [ , firstmonth [ , todaydate] ] ])
반환 데이터 유형: 부울
옵션 파라메타가 사용되지 않은 경우 현재 연도는 한 해의 1월 1일에서 마지막 스크립트 실행 날짜(포함)까지의 모든 날짜를 의미합니다.
인수:
| 인수 | 설명 |
|---|---|
| timestamp | The date to evaluate as a timestamp or expression resolving to a timestamp, to convert, for example '2012-10-12'. |
| yearoffset |
yearoffset을 지정하면 다른 연도의 동일한 기간에 대해 yeartodate가 True를 반환합니다. 음수 yearoffset은 이전 연도를 나타내고 양의 오프셋은 이후의 연도를 나타냅니다. 최근 날짜는 yearoffset = -1을 지정하여 얻습니다. 생략하면 0이 사용됩니다. |
| firstmonth |
firstmonth를 1과 12 사이(생략할 경우 1)로 지정하면 연도의 시작일을 원하는 달의 첫 날로 옮길 수 있습니다. 예를 들어 5월 1일에 시작되는 회계년도를 사용하려는 경우 firstmonth = 5를 지정합니다. |
| todaydate | todaydate(생략할 경우 마지막 스크립트 실행 시의 타임스탬프)를 지정하면 기간의 상한으로 사용된 날짜를 이동할 수 있습니다. |
예 및 결과:
다음 예에서는 마지막 재로드 시간 = 2011-11-18로 가정합니다.
| 예 | 결과 |
|---|---|
| yeartodate( '2010-11-18') | 반환 값: False |
| yeartodate( '2011-02-01') | 반환 값: True |
| yeartodate( '2011-11-18') | 반환 값: True |
| yeartodate( '2011-11-19') | 반환 값: False |
| yeartodate( '2011-11-19', 0, 1, '2011-12-31') | 반환 값: True |
| yeartodate( '2010-11-18', -1) | 반환 값: True |
| yeartodate( '2011-11-18', -1) | 반환 값: False |
| yeartodate( '2011-04-30', 0, 5) | 반환 값: False |
| yeartodate( '2011-05-01', 0, 5) | 반환 값: True |
