PowerApps의 DateAdd, DateDiff, TimeZoneOffset 함수DateAdd, DateDiff, and TimeZoneOffset functions in PowerApps

날짜/시간 값의 차이를 추가하거나 찾아서 현지 시간과 UTC 사이의 변환을 수행합니다.Adds to or finds the difference in date/time values and converts between local time and UTC.

설명Description

DateAdd 함수는 날짜/시간 값에 단위 수를 추가합니다.The DateAdd function adds a number of units to a date/time value. 결과는 새 날짜/시간 값입니다.The result is a new date/time value. 음수 값을 지정하여 날짜/시간 값에서 단위 수를 뺄 수도 있습니다.You can also subtract a number of units from a date/time value by specifying a negative value.

DateDiff 함수는 두 날짜/시간 값의 차이를 반환합니다.The DateDiff function returns the difference between two date/time values. 결과는 단위 수입니다.The result is a number of units.

두 함수 모두 밀리초, , , 시간, , , 분기 또는 연도 단위를 사용할 수 있습니다.For both functions, units can be Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. 기본적으로 두 함수 모두 을 단위로 사용합니다.By default, both functions use Days as units.

TimeZoneOffset 함수는 사용자의 현지 시간과 UTC(협정 세계시) 사이의 시간을 분 단위로 반환합니다.The TimeZoneOffset function returns the number of minutes between the user's local time and UTC (Coordinated Universal Time).

DateAddTimeZoneOffset을 사용하면 사용자의 현지 시간과 UTC(협정 세계시) 사이에서 변환이 가능합니다.You can use DateAdd with the TimeZoneOffset to convert between the user's local time and UTC (Coordinated Universal Time). TimeZoneOffset을 추가하면 현지 시간이 UTC로 변환되고 빼면(음수를 추가)하면 UTC에서 현지 시간으로 변환됩니다.Adding TimeZoneOffset will convert a local time to UTC, and subtracting it (adding the negative) will convert from UTC to local time.

날짜 및 시간 작업에서도 자세한 내용을 참조하세요.Also see working with dates and times for more information.

구문Syntax

DateAdd( DateTime, Addition [, Units ] )DateAdd( DateTime, Addition [, Units ] )

  • DateTime - 필수 항목이며,DateTime - Required. 연산을 수행할 날짜/시간 값입니다.Date/time value to operate on.
  • Addition - 필수 항목입니다.Addition - Required. DateTime에 추가할 Units에 해당하는 숫자입니다.Number, in Units, to add to the DateTime.
  • Units - 선택 사항입니다.Units - Optional. 추가할 단위 유형: 밀리초, , , 시간, , , 분기 또는 연도.The type of Units to add: Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. 지정하지 않으면 이 사용됩니다.If not specified, Days are used.

DateDiff( StartDateTime, EndDateTime [, Units ] )DateDiff( StartDateTime, EndDateTime [, Units ] )

  • StartDateTime - 필수 항목입니다.StartDateTime - Required. 시작 날짜/시간 값입니다.Starting date/time value.
  • EndDateTime - 필수 항목입니다.EndDateTime - Required. 종료 날짜/시간 값입니다.Ending date/time value.
  • Units - 선택 사항입니다.Units - Optional. 추가할 단위 유형: 밀리초, , , 시간, , , 분기 또는 연도.The type of Units to add: Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. 지정하지 않으면 이 사용됩니다.If not specified, Days are used.

TimeZoneOffset( [ DateTime ] )TimeZoneOffset( [ DateTime ] )

  • DateTime - 선택 사항입니다.DateTime - Optional. 오프셋을 반환할 날짜/시간 값입니다.Date/time value for which to return the offset. 기본적으로 현재 날짜/시간이 사용됩니다.By default, the current date/time is used.

Examples

이 모든 예에서 현재 날짜와 시간이 July 15, 2013, 1:02 PM이라고 가정합니다.In all of these examples, assume that the current date and time is July 15, 2013, 1:02 PM.

간단한 DateAddSimple DateAdd

수식Formula 설명Description 결과Result
Text( DateAdd( Now(), 3 ),
"dd-mm-yyyy hh:mm" )
Text( DateAdd( Now(), 3 ),
"dd-mm-yyyy hh:mm" )
현재 날짜 및 시간에 3일(기본 단위)을 추가합니다.Adds three days (default units) to the current date and time. "18-07-2013 13:02""18-07-2013 13:02"
Text( DateAdd( Now(), 4, Hours ),
"dd-mm-yyyy hh:mm" )
Text( DateAdd( Now(), 4, Hours ),
"dd-mm-yyyy hh:mm" )
현재 날짜 및 시간에 4시간을 추가합니다.Add four hours to the current date and time. "15-07-2013 17:02""15-07-2013 17:02"
Text( DateAdd( Today(), 1, Months ),
"dd-mm-yyyy hh:mm" )
Text( DateAdd( Today(), 1, Months ),
"dd-mm-yyyy hh:mm" )
현재 날짜에 시간 없이 한 달을 추가합니다. Today는 시간 구성 요소를 반환하지 않기 때문입니다.Adds one month to the current date, without time as Today doesn't return a time component. "15-08-2013 00:00""15-08-2013 00:00"
Text( DateAdd( Now(), ‑30, Minutes ),
"dd-mm-yyyy hh:mm" )
Text( DateAdd( Now(), ‑30, Minutes ),
"dd-mm-yyyy hh:mm" )
현재 날짜 및 시간에서 30분을 뺍니다.Subtracts 30 minutes from the current date and time. "15-07-2013 12:32""15-07-2013 12:32"

간단한 DateDiffSimple DateDiff

수식Formula 설명Description 결과Result
DateDiff( Now(), DateValue("1/1/2014") )DateDiff( Now(), DateValue("1/1/2014") ) 두 단위의 차이를 기본 단위인 로 반환합니다.Returns the difference between the two units in the default units of Days 170170
DateDiff( Now(), DateValue("1/1/2014"), Months )DateDiff( Now(), DateValue("1/1/2014"), Months ) 두 값의 차이를 단위로 반환합니다.Returns the difference between the two values in Months 66
DateDiff( Now(), Today(), Minutes )DateDiff( Now(), Today(), Minutes ) 현재 날짜/시간과 현재 날짜(시간 없음) 사이의 차이를 분 단위로 반환합니다.Returns the difference between the current date/time and the current date only (no time) in minutes. NowToday보다 늦기 때문에 결과는 음수가 됩니다.Since the Now is later than Today the result will be negative. -782-782

UTC로 변환Converting to UTC

UTC(협정 세계시)로 변환하려면 주어진 시간에 대한 TimeZoneOffset을 추가합니다.To convert to UTC (Coordinated Universal Time), add the TimeZoneOffset for the given time.

예를 들어 현재 날짜 및 시간이 PDT(태평양 일광 절약 시간), UTC-7 기준 July 15, 2013, 1:02 PM이라고 가정하겠습니다.For example, imagine the current date and time is July 15, 2013, 1:02 PM in Pacific Daylight Time (PDT, UTC-7). UTC 기준 현재 시간을 확인하려면 다음을 사용하십시오.To determine the current time in UTC, use:

  • DateAdd( Now(), TimeZoneOffset(), Minutes )DateAdd( Now(), TimeZoneOffset(), Minutes )

TimeZoneOffset의 기본값은 현재 시간이므로 인수를 전달할 필요가 없습니다.TimeZoneOffset defaults to the current time, so you don't need to pass it an argument.

결과를 보기 위해 dd-mm-yyyy hh:mm 형식으로 Text 함수를 사용하면 15-07-2013 20:02가 반환됩니다.To see the result, use the Text function with the format dd-mm-yyyy hh:mm, which will return 15-07-2013 20:02.

UTC에서 변환Converting from UTC

UTC에서 변환하려면 주어진 시간에서 TimeZoneOffset을 뺍니다(음수를 더합니다).To convert from UTC, subtract the TimeZoneOffset (by adding the negative) for the given time.

예를 들어 UTC 날짜 및 시간인 July 15, 2013, 8:02 PMStartTime이라는 변수에 저장되어 있다고 가정하겠습니다.For example, imagine the UTC date and time July 15, 2013, 8:02 PM is stored in a variable named StartTime. 사용자의 표준 시간대를 조정하려면 다음을 사용합니다.To adjust the time for the user's time zone, use:

  • DateAdd( StartTime, -TimeZoneOffset( StartTime ), Minutes )DateAdd( StartTime, -TimeZoneOffset( StartTime ), Minutes )

오프셋을 추가하지 않고 빼기 위해 TimeZoneOffset 앞에 음수 기호가 있습니다.Note the negative sign before TimeZoneOffset to subtract the offset rather than add it.

결과를 보기 위해 dd-mm-yyyy hh:mm 형식으로 Text 함수를 사용하면 사용자가 태평양 일광 절약 시간대에 있는 경우 15-07-2013 13:02가 반환됩니다.To see the result, use the Text function with the format dd-mm-yyyy hh:mm, which will result in 15-07-2013 13:02 if you're in Pacific Daylight Time.