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

Converte uma cadeia de data, hora ou de data e hora num 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 data (por exemplo, "01/10/2014") num 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 hora (por exemplo, "12:15") num 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 data e hora ("10 de janeiro de 2013 00:13") num 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 as informações relativas à hora da cadeia de data e a função TimeValue ignora as informações relativas à data da cadeia 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 predefinição, o idioma utilizado é o do utilizador atual, mas pode substituí-lo para se certificar de que as cadeias 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" e como 10 de janeiro em "fr".For example, "10/1/1920" is interpreted as October 1st in "en" and as January 10th in "fr".

As datas têm de se encontrar num dos seguintes 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

Veja o tópico relativo às funções Date e Time para efetuar conversões a partir de componentes numéricos de data, mês, ano, hora, minuto e segundo.See the Date and Time functions to convert from numeric components date, month, and year, and hour, minute, and second.

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

Para converter números, veja o tópico relativo à função Value.To convert numbers, see the Value function.

SintaxeSyntax

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

  • Cadeia – necessário.String - Required. Trata-se de uma cadeia de texto que contém um valor de data, hora ou de data e hora.A text string that contains a date, time, or combination date and time value.
  • Idioma – opcional.Language - Optional. Trata-se de uma cadeia de idioma como a que seria devolvida pelos dois primeiros carateres da função Language.A language string, such as would be returned by the first two characters from the Language function. Se tal não for indicado, é utilizado o idioma do cliente do utilizador atual.If not provided, the language of the current user's client is used.

ExemplosExamples

DateValueDateValue

Se tiver escrito 10/11/2014 num controlo de introdução de texto denominado Startdate e, em seguida, tiver definido a propriedade Text de uma etiqueta para a seguinte 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)

    A etiqueta apresentaria Saturday, October 11, 2014 se o seu computador estivesse definido para a região en.The label would show Saturday, October 11, 2014, if your computer were set to the en locale.

    Nota: pode utilizar 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 que seja apresentada uma lista destas opções, escreva o parâmetro seguido de ponto de exclamação na caixa de funções.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)

    A etiqueta apresentaria Monday, November 10, 2014.The label would show Monday, November 10, 2014.

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

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

    Se o seu computador estivesse definido para o idioma en, a etiqueta apresentaria 9, que indica o número de dias decorridos entre 11 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 apresentar a diferença em termos de meses, trimestres ou anos.The DateDiff function can also show the difference in months, quarters, or years.

DateTimeValueDateTimeValue

Se tiver escrito 10/11/2014 1:50:24.765 PM num controlo de introdução de texto denominado Start e, em seguida, tiver definido a propriedade Text de uma etiqueta para a seguinte 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)

    A etiqueta apresentaria Saturday, October 11, 2014 1:50:24 PM se o seu computador estivesse definido para a região "en".The label would show Saturday, October 11, 2014 1:50:24 PM if your computer were set to the "en" locale.

    Nota: pode utilizar 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 que seja apresentada uma lista destas opções, escreva o parâmetro seguido de ponto de exclamação na caixa de funções.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)

    A etiqueta apresentaria Monday, November 10, 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")

    A etiqueta apresentaria Saturday, October 11, 2014 01:50:24:765 PM se o seu computador estivesse definido para a região 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, 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

Atribua o controlo de introdução de texto FinishedAt e defina a propriedade Text de uma etiqueta para a seguinte 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"), "Conseguiu!", "Demasiado tarde!")If(TimeValue(FinishedAt.Text)<TimeValue("5:00:00.000 PM"), "You made it!", "Too late!")

  • Se escrever 4:59:59.999 PM no controlo FinishedAt, a etiqueta apresentará "Conseguiu!"If you type 4:59:59.999 PM into the FinishedAt control, the label shows "You made it!"
  • Se escrever 5:00:00.000 PM no controlo FinishedAt, a etiqueta apresentará "Demasiado tarde!".If you type 5:00:00.000 PM into the FinishedAt control, the label shows "Too late!"