Main Content

Establecer el formato de visualización de fechas y horas

Formatos para arreglos individuales de fecha y duración

Los arreglos datetime, duration y calendarDuration tienen una propiedad Format que controla la visualización de los valores de cada arreglo. Cuando crea un arreglo de fecha/hora, este utiliza el formato de visualización global predeterminado de fecha/hora de MATLAB®, a menos que proporcione un formato de manera explícita. Utilice la notación de puntos para acceder a la propiedad Format para ver o cambiar su valor. Por ejemplo, para establecer el formato de visualización en el arreglo datetime t en el formato predeterminado, escriba:

t.Format = 'default'

Cambiar la propiedad Format no cambia los valores del arreglo, solo su visualización. Por ejemplo, lo siguiente puede ser las representaciones del mismo valor datetime (las dos últimas no muestran ningún componente de hora):

Thursday, August 23, 2012 12:35:00
August 23, 2012
23-Aug-2012

La propiedad de Format de los tipos de datos datetime, duration y calendarDuration acepta diferentes formatos como entradas.

Formato de visualización de datetime

Puede establecer la propiedad Format en uno de estos vectores de caracteres.

Valor de FormatDescripción

'default'

Utilizar el formato de visualización predeterminado.

'defaultdate'

Utilizar el formato de visualización de fecha predeterminado que no muestra componentes de hora.

Para cambiar los formatos predeterminados, consulte Formato datetime predeterminado.

De manera alternativa, puede especificar un formato de fecha personalizado que incluya caracteres Unicode® como texto literal. En esta tabla se muestran varios formatos de visualización frecuentes y ejemplos de la salida con formato para la fecha de sábado, 19 de abril de 2014 a las 21:41:06 en Nueva York. En estos formatos puede utilizar caracteres ASCII que no sean letras, como guiones, espacios o puntos, o cualquier carácter no ASCII, para separar los campos de la fecha y la hora. Para incluir las letras ASCII A a Z y a a z como caracteres literales en el formato, enciérrelas entre comillas.

Valor de FormatEjemplo
'yyyy-MM-dd'2014-04-19
'dd/MM/yyyy'19/04/2014
'dd.MM.yyyy'19.04.2014
'yyyy年 MM月 dd日'2014年 04月 19日
'MMMM d, yyyy'19 de abril de 2014
'eeee, MMMM d, yyyy h:mm a'Sábado, 19 de abril de 2014 9:41 PM
'MMMM d, yyyy HH:mm:ss Z'19 de abril de 2014 21:41:06 -0400
'yyyy-MM-dd''T''HH:mmXXX' 2014-04-19T21:41-04:00

Para obtener una lista completa de los identificadores de símbolos válidos, consulte la propiedad Format de los arreglos de fecha y hora.

Nota

Los identificadores de letras que acepta datetime son diferentes de los que usan las funciones datestr, datenum y datevec.

Formato de visualización de duration

Para mostrar una duración como un solo número que incluya una parte fraccionaria (por ejemplo, 1,234 horas), especifique uno de estos vectores de caracteres:

Valor de Format Descripción
'y'Número de años exactos de longitud fija. Un año de longitud fija equivale a 365,2425 días.
'd'Número de días exactos de duración fija. Un día de duración fija equivale a 24 horas.
'h'Número de horas
'm'Número de minutos
's'Número de segundos

Para especificar el número de dígitos fraccionarios mostrados, utilice la función format.

Para mostrar una duración en forma de temporizador digital, especifique uno de los siguientes vectores de caracteres.

  • 'dd:hh:mm:ss'

  • 'hh:mm:ss'

  • 'mm:ss'

  • 'hh:mm'

También puede mostrar hasta nueve dígitos fraccionarios de segundo añadiendo hasta nueve caracteres S. Por ejemplo, 'hh:mm:ss.SSS' muestra los milisegundos de un valor de duración con tres dígitos.

Cambiar la propiedad Format no cambia los valores del arreglo, solo su visualización.

Formato de visualización de calendarDuration

Especifique la propiedad Format de un arreglo calendarDuration como un vector de caracteres que puede incluir los caracteres y, q, m, w, d y t, en este orden. El formato debe incluir m, d y t.

Esta tabla describe los componentes de fecha y hora que representan los caracteres.

CarácterUnidad¿Obligatorio?
yAñosno
qTrimestres (múltiplos de 3 meses)no
mMeses
wSemanasno
dDías
tHora (hora, minutos y segundos)

Para especificar el número de dígitos de los segundos fraccionarios, utilice la función format.

Si el valor de un componente de fecha u hora es cero, no se muestra.

Cambiar la propiedad Format no cambia los valores del arreglo, solo su visualización.

Formato datetime predeterminado

Puede establecer formatos predeterminados para controlar la visualización de los arreglos datetime que se creen sin un formato de visualización explícito. Estos formatos también se aplican cuando se establece la propiedad Format de un arreglo datetime en 'default' o 'defaultdate'. Cuando cambie la configuración predeterminada, los arreglos datetime configurados para utilizar los formatos predeterminados se muestran automáticamente utilizando la nueva configuración.

Los cambios en los formatos predeterminados son persistentes entre sesiones de MATLAB.

Para especificar un formato predeterminado, escriba

datetime.setDefaultFormats('default',fmt)
donde fmt es un vector de caracteres compuesto por las letras A a Z y a a z descrito para la propiedad Format de los arreglos datetime anteriores. Por ejemplo:
datetime.setDefaultFormats('default','yyyy-MM-dd hh:mm:ss')
establece el formato fecha/hora predeterminado que incluye un año de 4 dígitos, un número de mes de 2 dígitos, un número de día de 2 dígitos y valores de horas, minutos y segundos.

Además, puede especificar un formato predeterminado para fecha/hora creado sin componentes de hora. Por ejemplo:

datetime.setDefaultFormats('defaultdate','yyyy-MM-dd')
establece el formato de fecha predeterminado que incluye un año de 4 dígitos, un número de mes de 2 dígitos y un número de día de 2 dígitos.

Para restablecer los valores de fábrica tanto del formato predeterminado como del formato predeterminado con solo la fecha, escriba

datetime.setDefaultFormats('reset')
Los formatos predeterminados de fábrica dependen de la configuración regional de su sistema.

También puede establecer formatos predeterminados en el cuadro de diálogo Preferences. Para obtener más información, consulte Set Command Window Preferences.

Consulte también

| | |