Compartir por

DateValue TimeValue, e DateTimeValue funcións

Aplícase a: Aplicacións de lenzo Copilot Studio Fluxos de escritorio Aplicacións baseadas en modelos Power Platform CLI Dataverse funcións Power Pages

Converte a data, a hora ou as dúas cousas dunha cadea nun valor de data/hora.

Descripción

  • DateValue Converte unha cadea de data (como "10/01/2014") nun valor de data / hora .

  • TimeValue Converte unha cadea de tempo (como "12:15 PM") nun valor de data / hora .

  • DateTimeValue Converte unha cadea de data e hora (como "10 de xaneiro de 2013 12:13 AM") nun valor de data / hora .

DateValue A función ignora calquera información de hora na cadea de data, e TimeValue a función ignora calquera información de data na cadea de tempo.

Nota

As DateValuefuncións , TimeValuee DateTimeValue por defecto usan o idioma da configuración do usuario actual. Pode anulala para asegurarse de que as cadeas se interpreten correctamente. Por exemplo, "10/1/1920" interpretase como 1 de outubro en "en" e como 10 de xaneiro en "fr".

As datas deberán utilizar un destes formatos:

  • MM/DD/AAAA ou MM-DD-AAAA
  • DD/MM/AAAA ou DD-MM-AAAA
  • AAAA/MM/DD ou AAAA-MM-DD
  • MM/DD/AA ou MM-DD-AA
  • DD/MM/AA ou DD-MM-AA
  • DD Mes YYYY
  • Mes DD, AAAA

Para converter os compoñentes numéricos de data, mes e ano, lea Date.
Para converter desde compoñentes numéricos de hora, minuto e segundo, lea Time.

Para obter máis información, consulte:

Sintaxe

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

  • String : é necesario. Cadea de texto que contén unha data, hora ou un valor de data e hora de combinación.
  • Idioma - Opcional. Unha cadea de idioma, como a devolvería os dous primeiros caracteres da función Language. Se non se especifica, úsase o idioma da configuración do usuario actual.

DateValue( Dinámica )
DateTimeValue( Dinámica )
TimeValue( Dinámica )

  • Dinámico - Obrigatorio. Valor dinámico que representa unha data ou hora. Os valores aceptables dependen do provedor non tipificado. Para JSON, espérase que o valor dinámico sexa unha cadea JSON que conteña unha data e hora en formato ISO 8601. As datas ou horas noutros formatos provocan un erro. Considere converter eses valores a Texto primeiro e despois a data ou hora. Teña en conta que os fusos horarios e os formatos relacionados coa rexión son consideracións importantes cando se comunica con sistemas externos.

Exemplos

DateValue

Se escribe 11/10/2014 nun control de entrada de texto chamado Startdate e logo configura a propiedade Text dunha etiqueta nestas fórmulas:

  • Converta unha data dunha cadea na configuración local do usuario e mostre o resultado como unha data longa.

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

    Dispositivo configurado na configuración local gl mostra a etiqueta como Sábado, 11 de outubro de 2014.

    Nota

    Pode usar varias opcións coa enumeración DateTimeFormat. Para ver unha lista de opcións, escriba o parámetro seguido dun punto (.) na barra de fórmulas ou verifique a referencia da función Text.

  • Converta unha data dunha cadea na configuración local do francés e mostre o resultado como unha data longa. Neste exemplo, os meses e o día do mes interprétanse de xeito diferente ao inglés.

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

    Dispositivo configurado na configuración local gl mostra a etiqueta como Luns, 10 de novembro de 2014.

Se entras o 20 de outubro de 2014 :

  • Converta unha data a partir dunha cadea da configuración local do usuario e calcule a diferenza entre dous días, en días

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

    Dispositivo configurado na configuración rexional gl mostra a etiqueta como 9, indicando o número de días comprendidos entre o 11 e o 20 de outubro. A función DateDiff tamén pode mostrar a diferenza en meses, trimestres ou anos.

DateTimeValue

Se escribiu 11/10/2014 1:50:24.765 PM nun control de entrada de texto chamado Inicio e, a continuación, establece a propiedade Text dunha etiqueta na seguinte fórmula:

  • Converta unha cadea de data e hora da configuración local actual.

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

    Dispositivo configurado na configuración local gl mostra a etiqueta como Sábado, 11 de outubro de 2014 1:50:24 PM.

    Nota

    Pode usar varias opcións coa enumeración DateTimeFormat. Para ver unha lista de opcións, escriba o parámetro seguido dun punto (.) na barra de fórmulas ou verifique a referencia da función Text.

  • Converta unha cadea de data e hora da configuración local do francés. O mes e o día do mes interprétanse de forma diferente.

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

    Dispositivo configurado na configuración local gl mostra a etiqueta como Luns, 10 de novembro de 2014 1:50:24 PM.

  • Converta unha cadea de data e hora da configuración local do usuario e mostre o resultado cun segundo fraccionado.

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

    Dispositivo configurado na configuración local gl mostra a etiqueta como Sábado, 11 de outubro de 2014 01:50:24.765 PM.

    Como alternativa, pode especificar hh:mm:ss.f ou hh:mm:ss.ff para arredondar a hora á décima ou centésima de segundo máis próxima.

TimeValue

Asigne un control de entrada de texto FinishedAt e estableza a propiedade Text dunha etiqueta nesta fórmula:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Se escribe 4:59:59.999 PM no control FinishedAt, a etiqueta mostra Conseguíchelo!"
  • Se escribe 5:00:00.000 PM no control FinishedAt, a etiqueta mostra Demasiado tarde!"
  • Last updated on