DateValue, TimeValue 및 DateTimeValue 함수

  • 아티클

적용 대상: 캔버스 앱 데스크톱 흐름 모델 기반 앱 Power Platform CLI

문자열의 날짜, 시간 또는 둘 다를 날짜/시간 값으로 변환합니다.

설명

  • DateValue 함수는 날짜 문자열(예: "10/01/2014")을 날짜/시간 값으로 변환합니다.

  • TimeValue 함수는 시간 문자열(예: "12:15 PM")을 날짜/시간 값으로 변환합니다.

  • DateTimeValue 함수는 날짜 및 시간 문자열(예: "January 10, 2013 12:13 AM")을 날짜/시간 값으로 변환합니다.

DateValue 함수는 날짜 문자열의 시간 정보를 무시하며 TimeValue 함수는 시간 문자열의 날짜 정보를 무시합니다.

노트

DateValue, TimeValue, DateTimeValue 함수는 기본적으로 현재 사용자 설정의 언어를 사용합니다. 문자열이 올바르게 해석되도록 이를 재정의할 수 있습니다. 예를 들어 "10/1/1920"은 "en"에서는 10월 1일로, "fr"에서는 1월 10일로 해석됩니다.

날짜는 다음 형식 중 하나여야 합니다.

  • MM/DD/YYYY 또는 MM-DD-YYYY
  • DD/MM/YYYY 또는 DD-MM-YYYY
  • YYYY/MM/DD 또는 YYYY-MM-DD
  • MM/DD/YY 또는 MM-DD-YY
  • DD/MM/YY 또는 DD-MM-YY
  • DD Mon YYYY
  • Month DD, YYYY

날짜, 월, 연도 구성 요소에서 변환하려면 Date를 참조하십시오.
시간, 분, 초 구성 요소에서 변환하려면 Time을 참조하십시오.

자세한 내용은 다음을 참조하십시오.

구문

DateValue( String [, Language ])
DateTimeValue( String [, Language ])
TimeValue( String [, Language ])

  • String - 필수 항목입니다. 날짜, 시간 또는 날짜와 시간의 조합 값이 포함된 텍스트 문자열입니다.
  • Language - 선택 사항입니다. Language 함수의 첫 두 문자로 반환되는, 언어 문자열입니다. 제공되지 않으면 현재 사용자의 설정 언어가 사용됩니다.

DateValue( 무형식 )
DateTimeValue( 무형식 )
TimeValue( 무형식 )

  • Untyped - 필수 항목입니다. 무형식 개체로, 날짜 또는 시간을 나타냅니다. 허용되는 값은 무형식 공급자에 따라 다릅니다. JSON의 경우 무형식 개체는 ISO 8601 형식의 날짜 및 시간이 포함된 JSON 문자열이어야 합니다. 다른 형식의 날짜 또는 시간은 오류가 발생합니다. 이러한 값을 먼저 텍스트로 변환한 다음 날짜 또는 시간으로 변환하는 것이 좋습니다. 표준 시간대 및 로캘 관련 형식은 외부 시스템과 통신할 때 중요한 고려 사항입니다.

예

DateValue

Startdate라는 text-input 컨트롤에 10/11/2014를 입력한 다음, 레이블의 Text 속성을 다음 함수로 설정합니다.

  • 사용자 로캘 문자열에서 날짜를 변환하고 결과를 긴 날짜로 표시합니다.

    Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )

    디바이스가 en 로캘로 설정된 경우 레이블은 Saturday, October 11, 2014로 표시됩니다.

    노트

    DateTimeFormat 열거형으로 몇 가지 옵션을 사용할 수 있습니다. 옵션 목록을 표시하려면 수식 표시줄에서 매개 변수를 점 또는 마침표(.)와 함께 입력하거나 Text 함수 참조를 확인 바랍니다.

  • 프랑스어 로캘 문자열에서 날짜를 변환하고 결과를 긴 날짜로 표시합니다. 이 예에서 월과 일은 영어와 다르게 해석됩니다.

    Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )

    디바이스가 en 로캘로 설정된 경우 레이블은 Monday, November 10, 2014로 표시됩니다.

October 20, 2014를 입력한 경우 대신:

  • 사용자 로캘 문자열에서 날짜를 변환하고 이틀 간의 차이를 일 단위로 계산합니다.

    DateDiff( DateValue( Startdate.Text ), Today() )

    디바이스가 en 로캘로 설정된 경우 레이블은 9로 표시되어 10월 11일에서 10월 20일 사이의 일 수를 나타냅니다. DateDiff 함수는 월, 분기 또는 연도의 차이도 표시할 수 있습니다.

DateTimeValue

Start라는 텍스트 입력 컨트롤에 10/11/2014 1:50:24.765 PM을 입력한 다음, 레이블의 Text 속성을 다음 함수로 설정합니다.

  • 현재 로캘에서 날짜 및 시간 문자열을 모두 변환합니다.

    Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )

    디바이스가 en 로캘로 설정된 경우 레이블은 Saturday, October 11, 2014 1:50:24 PM으로 표시됩니다.

    노트

    DateTimeFormat 열거형으로 몇 가지 옵션을 사용할 수 있습니다. 옵션 목록을 표시하려면 수식 표시줄에서 매개 변수를 점 또는 마침표(.)와 함께 입력하거나 Text 함수 참조를 확인 바랍니다.

  • 프랑스어 로캘에서 날짜 및 시간 문자열을 모두 변환합니다. 월과 일은 다르게 해석됩니다.

    Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )

    디바이스가 en 로캘로 설정된 경우 레이블은 Monday, November 10, 2014 1:50:24 PM으로 표시됩니다.

  • 사용자 로캘의 날짜 및 시간 문자열을 모두 변환하고 결과를 소수 초로 표시합니다.

    Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )

    디바이스가 en 로캘로 설정된 경우 레이블은 Saturday, October 11, 2014 01:50:24.765 PM으로 표시됩니다.

    아니면 hh:mm:ss.f 또는 hh:mm:ss.ff를 지정하여 가장 가까운 10분의 1초나 100분의 1초로 시간을 반올림할 수 있습니다.

TimeValue

Text-input 컨트롤 이름을 FinishedAt으로 지정하고 레이블의 Text 속성을 다음 함수로 설정합니다.

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • FinishedAt 컨트롤에 4:59:59.999 PM을 입력하면 레이블에 "You made it!"이 표시됩니다.
  • FinishedAt 컨트롤에 5:00:00.000 PM을 입력하면 레이블에 "Too late!"이 표시됩니다.