Funciones DateValue, TimeValue y DateTimeValue

Se aplica a: Aplicaciones de lienzo Flujos de escritorio Aplicaciones basadas en modelos Power Platform CLI

Convierte una fecha o una hora, o ambas, de una cadena en un valor de fecha y hora.

Descripción

  • La función DateValue convierte una cadena de fecha (por ejemplo, "10/01/2014") en un valor de fecha y hora.

  • La función TimeValue convierte una cadena de hora (por ejemplo, "12:15 p. m.") en un valor de fecha y hora.

  • La función DateTimeValue convierte una cadena de fecha y hora (por ejemplo, "10 de enero de 2013, 12:13 a. m.") en un valor de fecha y hora.

La función DateValue ignora cualquier información de hora en la cadena de fecha y la función TimeValue ignora cualquier información de fecha en la cadena de hora.

Nota

Las funciones DateValue, TimeValue y DateTimeValue utilizan de forma predeterminada el idioma de la configuración actual del usuario. Puede reemplazarlo para asegurarse de que las cadenas se interpretan correctamente. Por ejemplo, "10/1/1920" se interpreta como el 1 de octubre en "inglés" y como 10 de enero en "francés".

Las fechas deben estar en uno de estos formatos:

  • MM/DD/AAAA o MM-DD-AAAA
  • DD/MM/AAAA o DD-MM-AAAA
  • AAAA/MM/DD o AAAA-MM-DD
  • MM/DD/AA o MM-DD-AA
  • DD/MM/AA o DD-MM-AA
  • DD Mes AAAA
  • Mes DD, AAAA

Para convertir componentes numéricos de fecha, mes y año, lea Date.
Para convertir componentes numéricos de hora, minuto y segundo, lea Time.

Para obtener más información, lea:

Sintaxis

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

  • String: requerido. Una cadena de texto que contiene un valor de fecha, de hora, o una combinación de ambas.
  • Language: opcional. Una cadena de idioma, como la que devuelven los dos primeros caracteres de la función Language. Si no se indica, se utilizará el idioma de la configuración del usuario actual.

DateValue( Untyped )
DateTimeValue( Untyped )
TimeValue( Untyped )

  • Untyped - requerido. Objeto Untyped que representa una fecha u hora. Los valores aceptables dependen del proveedor sin tipo. Para JSON, se espera que el objeto sin tipo sea una cadena JSON que contenga una fecha y hora en formato ISO 8601. Las fechas u horas en otros formatos generarán un error. Considere convertir tales valores a Texto primero, luego a una fecha u hora. Tenga en cuenta que las zonas horarias y los formatos relacionados con la configuración regional son consideraciones importantes al comunicarse con sistemas externos.

Ejemplos

DateValue

Si escribe 10/11/2014 en un control de entrada de texto denominado Startdate y, después, establece la propiedad Text de una etiqueta en estas fórmulas:

  • Convierte una fecha de una cadena en la configuración regional del usuario y muestra el resultado como una fecha larga.

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

    El dispositivo configurado con la configuración regional de inglés muestra la etiqueta como sábado, 11 de octubre de 2014.

    Nota

    Puede usar varias opciones con la enumeración DateTimeFormat. Para mostrar una lista de opciones, escriba el parámetro seguido de un punto (.) en la barra de fórmulas o consulte Referencia de la función Text.

  • Convierte una fecha de una cadena en la configuración regional del francés y muestra el resultado como una fecha larga. En este ejemplo, los meses y el día del mes se interpretan de manera diferente al inglés.

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

    El dispositivo configurado con la configuración regional de francés muestra la etiqueta como lunes, 10 de noviembre de 2014.

Si escribió 20 de octubre de 2014 en su lugar:

  • Convierte una fecha de una cadena en la configuración regional del usuario y calcula la diferencia entre dos días, en días.

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

    El dispositivo configurado con la configuración regional de inglés muestra la etiqueta como 9, indicando el número de días entre el 11 y el 20 de octubre. La función DateDiff también puede mostrar la diferencia en meses, trimestres o años.

DateTimeValue

Si escribió 10/11/2014 1:50:24.765 p. m. en un control de entrada de texto denominado Start y, después, estableció la propiedad Text de una etiqueta en la siguiente fórmula:

  • Convierte una cadena de fecha y hora en la configuración regional actual.

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

    El dispositivo configurado con la configuración regional de inglés muestra la etiqueta como sábado, 11 de octubre de 2014 1:50:24 p. m..

    Nota

    Puede usar varias opciones con la enumeración DateTimeFormat. Para mostrar una lista de opciones, escriba el parámetro seguido de un punto (.) en la barra de fórmulas o consulte Referencia de la función Text.

  • Convierte una cadena de fecha y hora en la configuración regional de francés. El mes y el día del mes se interpretan de manera diferente.

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

    El dispositivo configurado con la configuración regional de francés muestra la etiqueta como lunes, 10 de noviembre de 2014 1:50:24 p. m..

  • Convierte una cadena de fecha y hora en la configuración regional del usuario y muestra el resultado con un segundo fraccionario.

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

    El dispositivo configurado con la configuración regional de inglés muestra la etiqueta como sábado, 11 de octubre de 2014 01:50:24.765 p. m..

    Como alternativa, puede especificar hh:mm:ss.f o hh:mm:ss.ff para redondear la hora a la décima o centésima de segundo más cercana.

TimeValue

Asigne el nombre FinishedAt a un control de entrada de texto y establezca la propiedad Text de una etiqueta en esta fórmula:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Si escribe 4:59:59.999 PM en el control FinishedAt la etiqueta mostrará el texto "You made it!"
  • Si escribe 5:00:00.000 PM en el control FinishedAt, la etiqueta mostrará el texto "Too late!"