Funções DateValue, TimeValue e DateTimeValue no PowerAppsDateValue, TimeValue, and DateTimeValue functions in PowerApps

Converte uma data, hora ou ambas em uma cadeia de caracteres para um valor de data/hora.Converts a date, a time, or both in a string to a date/time value.

DescriçãoDescription

A função DateValue converte uma cadeia de caracteres de data (por exemplo, "01/10/2014") em um valor de data/hora.The DateValue function converts a date string (for example, "10/01/2014") to a date/time value.

A função TimeValue converte uma cadeia de caracteres de hora (por exemplo, "12:15 PM") em um valor de data/hora.The TimeValue function converts a time string (for example, "12:15 PM") to a date/time value.

A função DateTimeValue converte uma cadeia de caracteres de data e hora (por exemplo, "10 de janeiro de 2013, 12:13") em um valor de data/hora.The DateTimeValue functions converts a date and time string (for example, "January 10, 2013 12:13 AM") to a date/time value.

A função DateValue ignora todas as informações sobre a hora na cadeia de caracteres de data e a função TimeValue ignora todas as informações de data na cadeia de caracteres de hora.The DateValue function ignores any time information in the date string, and the TimeValue function ignores any date information in the time string.

Por padrão, a linguagem usada é a mesma do usuário atual, mas você pode substituí-la para garantir que as cadeias de caracteres são interpretadas corretamente.By default, the language used is that of the current user, but you can override this to ensure that strings are interpreted properly. Por exemplo, "10/1/1920" é interpretado como 1º de outubro em "en" (inglês) e como 10 de janeiro em "fr" (francês).For example, "10/1/1920" is interpreted as October 1st in "en" and as January 10th in "fr".

As datas devem estar em um destes formatos:Dates must be in one of these formats:

  • MM/DD/AAAAMM/DD/YYYY
  • DD/MM/AAAADD/MM/YYYY
  • DD Mês AAAADD Mon YYYY
  • Mês DD, AAAAMonth DD, YYYY

Consulte as funções Date e Time para converter data, mês e ano e a hora, minuto e segundo a partir de componentes numéricos.See the Date and Time functions to convert from numeric components date, month, and year, and hour, minute, and second.

Consulte também Trabalhar com datas e horas para obter mais informações.Also see working with dates and times for more information.

Para converter números, consulte a função Value.To convert numbers, see the Value function.

SintaxeSyntax

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

  • String - obrigatório.String - Required. Uma cadeia de caracteres de texto que contém um valor de data e hora ou uma combinação de ambas.A text string that contains a date, time, or combination date and time value.
  • Idioma - opcional.Language - Optional. Uma cadeia de caracteres de idioma, como seria retornado pelos dois primeiros caracteres da função Language.A language string, such as would be returned by the first two characters from the Language function. Se não fornecido, o idioma do cliente do usuário atual será usado.If not provided, the language of the current user's client is used.

ExemplosExamples

DateValueDateValue

Se você digitou 11/10/2014 em um controle de entrada de texto chamado Startdate e definiu a propriedade Text de um rótulo com esta função:If you typed 10/11/2014 into a text-input control named Startdate and then set the Text property of a label to this function:

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

    O rótulo deve mostrar Sábado, 11 de outubro de 2014, se o seu computador foi configurado para a localidade en.The label would show Saturday, October 11, 2014, if your computer were set to the en locale.

    Observação: Você pode usar várias opções diferentes de LongDateTime, com o parâmetro DateTimeFormat.Note: You can use several options, other than LongDateTime, with the DateTimeFormat parameter. Para exibir uma lista dessas opções, digite o parâmetro, seguido de um ponto de exclamação, na caixa de função.To display a list of those options, type the parameter, followed immediately by an exclamation point, in the function box.

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

    O rótulo deve mostrar Segunda-feira, 10 de novembro de 2014.The label would show Monday, November 10, 2014.

Se você fez a mesma coisa em 20 de outubro de 2014:If you did the same thing on October 20, 2014:

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

    Se o computador estivesse definido para o idioma en, o rótulo mostra 9, que indica o número de dias entre 11 de outubro e 20 de outubro.If your computer were set to the en language, the label would show 9, indicating the number of days between October 11 and October 20. A função DateDiff também pode mostrar a diferença em meses, trimestres ou anos.The DateDiff function can also show the difference in months, quarters, or years.

DateTimeValueDateTimeValue

Se você digitou 11/10/2014 1h50min24,765s em um controle de texto de entrada chamado Start e definiu a propriedade Text de um rótulo com esta função:If you typed 10/11/2014 1:50:24.765 PM into a text-input control named Start and then set the Text property of a label to this function:

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

    O rótulo deve mostrar Sábado, 11 de outubro de 2014 1:50:24 PM, se o seu computador foi configurado para a localidade “en”.The label would show Saturday, October 11, 2014 1:50:24 PM if your computer were set to the "en" locale.

    Observação: Você pode usar várias opções diferentes de LongDateTime, com o parâmetro DateTimeFormat.Note: You can use several options, other than LongDateTime, with the DateTimeFormat parameter. Para exibir uma lista dessas opções, digite o parâmetro, seguido de um ponto de exclamação, na caixa de função.To display a list of those options, type the parameter, followed immediately by an exclamation point, in the function box.

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

    O rótulo deve mostrar Segunda-feira, 10 de novembro de 2014 1:50:24 PM.The label would show Monday, November 10, 2014 1:50:24 PM.

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

    O rótulo deve mostrar Sábado, 11 de outubro de 2014 01:50:24:765 PM, se o seu computador foi configurado para a localidade en.The label would show Saturday, October 11, 2014 01:50:24:765 PM if your computer were set to the en locale.

    Como alternativa, você pode especificar hh:mm:ss.f ou hh:mm:ss.ff para arredondar a hora para o décimo ou centésimo de segundo mais próximo.As an alternative, you can specify hh:mm:ss.f or hh:mm:ss.ff to round the time to the nearest tenth or hundredth of a second.

TimeValueTimeValue

Nomeie um controle de entrada de texto FinishedAt e, depois, defina a propriedade Text de um rótulo com esta função:Name a text-input control FinishedAt, and set the Text property of a label to this function:

If(TimeValue(FinishedAt.Text)<TimeValue("5:00:00.000 PM"), "Você chegou na hora!", "Você está atrasado!")If(TimeValue(FinishedAt.Text)<TimeValue("5:00:00.000 PM"), "You made it!", "Too late!")

  • Se você digitar 4:59:59.999 PM no controle FinishedAt, o rótulo mostra "Você chegou na hora!"If you type 4:59:59.999 PM into the FinishedAt control, the label shows "You made it!"
  • Se você digitar 5:00:00.000 PM no controle FinishedAt, o rótulo mostra "Você está atrasado!"If you type 5:00:00.000 PM into the FinishedAt control, the label shows "Too late!"