Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday 함수
적용 대상:
캔버스 앱 데스크톱 흐름 Dataverse 수식 열 모델 기반 앱 Power Platform CLI
현재 날짜와 시간을 반환하고, 날짜/시간 값이 오늘인지 테스트합니다.
노트
PAC CLI pac power-fx 명령은 UTCNow, UTCToday 및 IsUTCToday 함수를 지원하지 않습니다.
Description
Now 함수는 현재 날짜와 시간을 날짜/시간 값으로 반환합니다.
Today 함수는 현재 날짜를 날짜/시간 값으로 반환합니다. 시간 부분은 자정입니다. Today는 오늘 자정부터 내일 자정까지의 하루 동안에 동일한 값을 갖습니다.
IsToday 함수는 날짜/시간 값이 오늘 자정과 내일 자정 사이에 속하는지 여부를 테스트합니다. 이 함수는 부울(true 또는 false) 값을 반환합니다.
Now, Today 및 IsToday 함수는 현재 사용자의 현지 시간으로 작동합니다.
UTCNow, UTCToday 및 IsUTCToday 함수는 UTC가 아닌 카운터파트와 동일하지만 시간대 독립적인 값으로 작동하고 협정 세계시(UTC)를 사용합니다.
노트
- UTCNow, UTCToday 및 IsUTCToday는 Microsoft Dataverse for Teams 수식 열에만 사용할 수 있으며 시간에 독립적인 필드 및 값에만 해당합니다.
- Now, Today 및 IsToday는 현재 사용자의 현지 시간대에 대한 정보 없이 평가가 수행되므로 Dataverse for Teams 수식 열에 사용할 수 없습니다.
추가 정보: Dataverse for Teams의 수식 테이블 열 작업
자세한 내용은 데이터 형식 설명서의 Date, Time 및 DateTime 및 날짜 및 시간 작업을 참조하세요.
일시적 함수
Now, Today, UTCNow 및 UTCToday는 일시적 함수입니다. 이러한 함수는 각 평가에 대해 다른 값을 반환합니다.
데이터 흐름 수식을 사용하면 표시되는 수식을 다시 계산하는 경우 일시적 함수는 다른 값만을 반환합니다. 수식에서 변경되는 내용이 없으면 앱의 실행 과정에서 같은 값을 갖습니다.
예를 들어 앱이 활성화되어 있는 동안 Label1.Text = Now()를 포함한 레이블 컨트롤은 변경되지 않습니다. 앱을 닫았다가 다시 열면 새로운 값이 나타납니다.
함수가 다른 내용이 변경된 수식의 일부인 경우 다시 평가됩니다. 예를 들어 이 예제가 Label1.Text = DateAdd( Now(), Slider1.Value, Minutes )를 포함한 슬라이더 컨트롤을 포함하도록 변경하면 Slider 컨트롤의 값이 변경되고 레이블의 텍스트 속성이 다시 평가될 때마다 현재 시간이 검색됩니다.
동작 수식에서 사용될 경우 일시적 함수는 동작 수식이 계산될 때마다 평가됩니다. 예는 아래를 참조하세요.
구문
사용자의 현지 시간 사용
Now()
Today()
IsToday( DateTime )
- DateTime - 필수 항목입니다. 테스트할 날짜/시간 값입니다.
UTC(협정 세계시) 사용
UTCNow()
UTCToday()
IsUTCToday( TimeZoneIndependentTime )
- TimeZoneIndependentDateTime - 필수 항목입니다. 테스트할 시간에 독립적인 날짜/시간 값입니다.
예
이 섹션의 예에서 현재 시간은 태평양 표준시(UTC-8) 기준 2021년 7월 11일오후 8:58이며 언어는 en-us입니다.
| 수식 | 설명 | 결과 |
|---|---|---|
| Text( Now(), "mm/dd/yyyy hh:mm:ss" ) | 현재 날짜와 시간을 사용자의 표준 시간대로 검색하고, 이를 문자열로 표시합니다. | "07/11/2021 20:58:00" |
| Text( Today(), "mm/dd/yyyy hh:mm:ss" ) | 시간 부분은 자정으로 유지한 채 현재 날짜만 검색하여 문자열로 표시합니다. | "07/12/2021 00:00:00" |
| IsToday( Now() ) | 현재 날짜와 시간이 오늘 자정과 내일 자정 사이에 속하는지 여부를 테스트합니다. | true |
| IsToday( Today() ) | 현재 날짜가 오늘 자정과 내일 자정 사이에 속하는지 여부를 테스트합니다. | true |
| Text( DateAdd( Now(), 12 ), "mm/dd/yyyy hh:mm:ss" ) | 현재 날짜와 시간을 검색하고, 결과에 12일을 추가하여 이를 문자열로 표시합니다. | "07/23/2021 20:58:00" |
| Text( DateAdd( Today(), 12 ), "mm/dd/yyyy hh:mm:ss" ) | 현재 날짜를 검색하고, 결과에 12일을 추가하여 이를 문자열로 표시합니다. | "07/23/2021 00:00:00" |
| IsToday( DateAdd( Now(), 12 ) ) | 현재 날짜와 시간에 12일을 추가한 값이 오늘 자정과 내일 자정 사이에 속하는지 여부를 테스트합니다. | false |
| IsToday( DateAdd( Today(), 12 ) ) | 현재 날짜에 12일을 추가한 값이 오늘 자정과 내일 자정 사이에 속하는지 여부를 테스트합니다. | false |
| Hour( UTCNow() ) | 현재 날짜와 시간을 UTC로 검색하고 현지 시간보다 8시간 빠른 시간만 추출합니다. | 4 |
| Day( UTCToday() ) | 현재 날짜만 UTC로 검색하고 현지 시간보다 1일 빠른 날짜만 추출합니다. | 12 |
| IsUTCToday( UTCNow() ) | 현재 날짜와 시간이 오늘 자정과 내일 자정 사이에 속하는지 여부를 테스트합니다(모두 UTC 시간). | true |
| IsUTCToday( UTCToday() ) | 현재 날짜가 오늘 자정과 내일 자정 사이에 속하는지 여부를 테스트합니다(모두 UTC 시간). | true |
실시간으로 업데이트되는 시계 표시
Timer 컨트롤을 추가하고, 해당 Duration 속성을 1000으로 설정하고, 해당 Repeat 속성을 true로 설정합니다.
타이머는 1초 동안 실행되고, 자동으로 다시 시작되며, 해당 패턴을 계속합니다.
컨트롤의 OnTimerEnd 속성을 이 수식으로 설정합니다.
Set( CurrentTime, Now() )
(매초 후에) 타이머가 다시 시작될 때마다 이 수식은 CurrentTime 전역 변수를 Now 함수의 현재 값으로 설정합니다.
Label 컨트롤을 추가하고, Text 속성을 다음 수식으로 설정합니다.
Text( CurrentTime, LongTime24 )
Text 함수를 사용하여 원하는 시간 및 날짜를 지정하거나 이 속성을 CurrentTime으로 설정하여 시간 및 분을 표시합니다(초 제외).
F5 키를 눌러 앱을 미리 본 다음, 클릭하거나 탭하여 타이머를 시작합니다.
레이블은 지속적으로 현재 시간을 보여줍니다(초 포함).
타이머의 AutoStart 속성을 true로 설정하고 해당 Visible 속성을 false로 설정합니다.
타이머는 표시되지 않으며 자동으로 시작합니다.
다음 예제와 같이 CurrentTime 변수에 유효한 값이 있도록 화면의 OnStart 속성을 설정합니다.
Set(CurrentTime, Now())
(1초 동안 타이머를 실행하기 전에) 앱이 시작되자마자 레이블이 나타납니다.