Los formatos de fecha y hora, y de número te permiten controlar cómo aparecen tus datos en una hoja. Hojas de cálculo de Google proporciona algunos formatos comunes para elegir, pero también puedes definir tus propios formatos.
En la IU de Hojas de cálculo, puedes aplicar formatos de números y fechas a las celdas con el menú Formato > Número. En la API de Hojas de cálculo, estableces estos formatos con una llamada al método spreadsheets.batchUpdate para enviar un UpdateCellsRequest o un RepeatCellRequest.
En esta página, se describe cómo definir nuevos patrones de formato de fecha y número, que puedes incluir en tu solicitud a la API. En el ejemplo Cómo configurar un formato decimal o de fecha y hora personalizado para un rango, se muestra cómo establecer un patrón de formato con la API. Ten en cuenta que la renderización real del formato depende del locale de la hoja de cálculo. En esta guía, se supone que locale es en_US. Para determinar el locale de una hoja de cálculo, lee el SpreadsheetProperties con una solicitud spreadsheets.get.
Acerca de los valores de fecha y hora
Hojas de cálculo, como la mayoría de las otras aplicaciones de hoja de cálculo, trata los valores de fecha y hora como valores decimales. Esto te permite realizar operaciones aritméticas en fórmulas, de modo que puedas incrementar días o semanas, sumar o restar dos fechas y horas, y realizar otras operaciones similares.
Hojas de cálculo usa una forma de fecha de época que se usa comúnmente en las hojas de cálculo. La parte entera del valor (a la izquierda del decimal) cuenta los días desde el 30 de diciembre de 1899. La parte fraccionaria (a la derecha del punto decimal) cuenta el tiempo como una fracción de un día. Por ejemplo, el 1 de enero de 1900 a mediodía es 2.5, 2 porque son 2 días después del 30 de diciembre de 1899 y 0.5 porque el mediodía es medio día. El 1 de febrero de 1900 a las 3 p.m. es 33.625.
Hojas de cálculo trata correctamente el año 1900 como un año común, no como un año bisiesto.
Patrones de formato de fecha y hora
Un patrón de formato de fecha y hora es una cadena de subcadenas de tokens que, cuando se analizan, se reemplazan por los elementos de fecha y hora correspondientes (como el mes o la hora).
Tokens de formato de fecha y hora
En la siguiente tabla, se definen las subcadenas de tokens que puedes usar en un patrón de formato de fecha y hora. Un carácter + indica que el carácter anterior puede aparecer una o más veces y, de todos modos, coincidir con el patrón. Los caracteres que no aparecen en la siguiente tabla se tratan como literales y se muestran sin cambios.
| Token | Descripción |
|---|---|
h |
Hora del día. Alterna entre el formato de 12 y 24 horas según si hay un indicador de a.m. o p.m. en la cadena. |
hh+ |
Igual que el anterior, pero con un 0 a la izquierda para los números del 1 al 9. |
m |
Si el token no literal anterior era de horas o el siguiente es de segundos, representa minutos en la hora (sin un 0 a la izquierda). De lo contrario, representa el mes del año como un número (sin un 0 a la izquierda). |
M |
El mes del año sin un 0 a la izquierda. Usa este token para indicar expresamente un mes, en lugar de un minuto, en tu patrón. |
mm |
Igual que m, pero con un 0 a la izquierda en ambos casos. |
MM |
Es el mes del año con un 0 a la izquierda. Usa este token para indicar expresamente un mes, en lugar de un minuto, en tu patrón. |
mmm |
Es la abreviatura del mes de tres letras (por ejemplo, "feb"). |
mmmm |
El nombre completo del mes mmmmmm+ también coincide con esto. |
mmmmm |
Es la primera letra del mes (por ejemplo, "J" para junio). |
s |
Son los segundos del minuto sin un 0 a la izquierda. |
ss |
Son los segundos del minuto con un 0 a la izquierda. |
[h+] |
Cantidad de horas transcurridas en un período. La cantidad de letras indica la cantidad mínima de dígitos (se agregan 0 iniciales). |
[m+] |
Cantidad de minutos transcurridos en un período. La cantidad de letras indica la cantidad mínima de dígitos (se agregan 0 iniciales). |
[s+] |
Es la cantidad de segundos transcurridos en una duración. La cantidad de letras indica la cantidad mínima de dígitos (se agregan 0 iniciales). |
d |
Es el día del mes, sin un 0 a la izquierda para los números inferiores a 10. |
dd |
Es el día del mes, con un 0 a la izquierda para los números inferiores a 10. |
ddd |
Día de la semana, abreviatura de tres letras (por ejemplo, "lun"). |
dddd+ |
Día de la semana, nombre completo |
y |
Año de 2 dígitos. |
yy |
|
yyy |
Año (4 dígitos). |
yyyy+ |
|
a/p |
Muestra "a" para a.m. y "p" para p.m. También cambia las horas al formato de 12 horas. Si la letra del token está en mayúsculas, el resultado también lo estará. |
am/pm |
Igual que el anterior, pero muestra "AM" o "PM" y siempre está en mayúsculas. |
0 |
Décimos de segundo. Puedes aumentar la precisión a dos dígitos con 00 o a tres dígitos (milisegundos) con 000. |
\ |
Trata el siguiente carácter como un valor literal y no como un significado especial que pueda tener. |
"text" |
Muestra el texto dentro de las comillas como un literal. |
Ejemplos de formatos de fecha y hora
Dada la fecha y la hora Tuesday, April 5, 2016, 4:08:53.528 PM, en la siguiente tabla, se muestran algunos patrones de ejemplo y su renderización de fecha y hora correspondiente. En la segunda sección de la tabla, se muestran ejemplos de formatos de tiempo transcurrido para un tiempo transcurrido de 3 hours, 13 minutes, 41.255 seconds:
| Patrones de fecha y hora | Tuesday, April 5, 2016, 4:08:53.528 PM |
|---|---|
h:mm:ss.00 a/p |
4:08:53.53 p |
hh:mm A/P".M." |
4:08 p.m. |
yyyy-mm-dd |
2016-04-05 |
mmmm d \[dddd\] |
5 de abril [martes] |
h PM, ddd mmm dd |
4 p.m., martes 5 de abr |
dddd, m/d/yy at h:mm |
Martes, 5/4/16 a las 4:08 p.m. |
| Patrones de tiempo transcurrido | 3 hours, 13 minutes, 41.255 seconds |
[hh]:[mm]:[ss].000 |
03:13:41.255 |
[mmmm]:[ss].000 |
0193:41.255 |
Patrones de formato de número
Un patrón de formato de número es una cadena de subcadenas de tokens que, cuando se analizan, se reemplazan por las representaciones numéricas correspondientes. Un patrón de formato de número puede constar de hasta cuatro secciones, separadas por punto y coma, que definen los formatos separados que se usan para números positivos, números negativos, cero y texto (en ese orden):
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
No es necesario que incluyas las cuatro secciones en un formato. Si solo incluyes una sección, se usará ese formato para todos los valores. El uso de dos secciones hace que el primer formato se aplique a los números cero y positivos, y el segundo formato a los números negativos. El uso de tres secciones define formatos separados para números positivos, negativos y cero. Por ejemplo:
[NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]
Sin embargo, si hay dos o más secciones y la sección final es un formato de texto, esa sección se trata como el formato de texto y las demás se comportan como si hubiera una sección menos. Por lo tanto, si incluyes un formato de texto final, es posible definir formatos como los siguientes:
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
El análisis de un formato en secciones ocurre antes de otros análisis, por lo que es posible incluir un formato de fecha o hora como una de las secciones (aunque esto tiene una utilidad limitada).
Tokens de formato numérico
En la siguiente tabla, se definen las subcadenas de tokens que puedes usar en una sección de formato para definir cómo representar los valores de esa sección.
| Token | Descripción |
|---|---|
0 |
Representa un dígito en el número. Si el dígito es un 0 insignificante, se renderiza como 0. Por ejemplo, el formato de número 00.0 renderiza el número 3 como "03.0". |
# |
Representa un dígito en el número. Si el dígito es un 0 insignificante, no se renderiza. Por ejemplo, el formato de número ##0 muestra el número 12 como "12". |
? |
Representa un dígito en el número. Si el dígito es un 0 insignificante, se renderiza como un espacio. Esto se usa a menudo para alinear la coma decimal en una columna cuando se usan fuentes de ancho fijo. Por ejemplo, el formato de número ???.??? renderiza el número 12.4 de la siguiente manera: “12.4”. |
. |
El primer punto representa la coma decimal en el número. Los períodos posteriores se renderizan como literales. Si incluyes un punto decimal en el formato, siempre se renderiza, incluso para números enteros. Por ejemplo, #0.# renderiza el número 3 como "3.". |
% |
Aparece como un literal, pero también hace que los números existentes se multipliquen por 100 antes de renderizarse para que los porcentajes sean más legibles. Por ejemplo, el formato de número #% muestra el número 0.25 como "25%". |
, |
Si aparece entre caracteres de dos dígitos (0, # o ?), renderiza el número completo con separadores de agrupación (agrupación por miles). Si sigue a los caracteres de dígitos, escala los dígitos por mil por coma (por ejemplo, el formato #0.0,, renderiza el número 12,200,000 como 12.2). |
E- |
Renderiza el número en formato científico, con el formato a la izquierda de E que se usa para la parte no exponencial y el formato a la derecha de E que se usa para la parte exponencial. E+ muestra un signo + para los exponentes positivos. E- solo muestra un signo para exponentes negativos. Si se usan letras minúsculas, el e de salida también estará en minúsculas.
Por ejemplo, el formato de número ##0.00#E+## muestra el número 0.0000001 como "100.00E-9". |
E+ |
|
e- |
|
e+ |
|
/ |
Si aparece entre caracteres de dos dígitos (0, # o ?), trata esos grupos de dígitos como un formato de fracción. Por ejemplo, el formato de número 0 #/# renderiza el número 23.25 como 23 1/4. El denominador también puede ser un número entero literal, en cuyo caso se aplica ese número entero como denominador. El formato de número 0 #/8 muestra el número 23.25 como 23 2/8. La parte fraccionaria no se renderiza si el numerador se convierte en 0. El número 23.1 con el formato de número 0 #/3 se renderiza como 23 (porque el 0.1 se redondea a 0/3). / no es compatible con el formato científico ni con un formato con punto decimal. |
* |
Se incluye para garantizar la compatibilidad con los formatos de números de Microsoft Excel. Actualmente se ignora. |
_ |
El token de guion bajo omite el siguiente carácter y renderiza un espacio. Se usa para alinear los formatos de número en los que el valor negativo está rodeado de paréntesis. |
\ |
Trata el siguiente carácter como un valor literal y no como un significado especial que pueda tener. Por ejemplo, el formato de número \#0 muestra el número 10 como "#10". |
"text" |
Muestra el texto dentro de las comillas como un literal. |
@ |
Si la celda tiene una entrada de texto, se inserta el texto sin procesar de la celda. No es compatible con ninguno de los otros caracteres especiales y no se muestra para los valores numéricos (que se muestran como formato general). |
$ - + ( ) : space |
Hojas de cálculo trata estos caracteres como literales y los muestra sin cambios. |
Instrucciones de meta
Además, cada una de las secciones de formato puede tener instrucciones meta opcionales, encerradas en caracteres [], que preceden al formato y proporcionan instrucciones adicionales. Existen dos tipos de instrucciones meta, y una sección determinada puede usar ambos:
| Instrucción | Descripción |
|---|---|
[condition] |
Reemplaza la comparación predeterminada positiva, negativa o cero de la sección por otra expresión condicional. Por ejemplo, [<100]”Low”;[>1000]”High”;000 renderiza la palabra "Bajo" para valores inferiores a 100, "Alto" para valores superiores a 1, 000 y un número de tres dígitos (con 0 a la izquierda) para cualquier valor intermedio. Las condiciones solo se pueden aplicar a los dos primeros subformatos y, si un número coincide con más de uno, se usa el primero con el que coincide. Si hay un tercer formato, se usa para “todo lo demás”. De lo contrario, si un número no coincide con ninguno de los formatos, se renderiza como todos los “#” que ocupan el ancho de la celda. Si existe, el cuarto formato siempre se usa para el texto. |
[Color] or [Color#] |
Hace que cualquier valor que renderice este subformato aparezca con el color de texto determinado. Los valores válidos para Color son negro, azul, cian, verde, magenta, rojo, blanco o amarillo. Los valores válidos para el "#" en Color# son del 1 al 56 (esta paleta de colores muestra una lista de los colores que corresponden a cada número). Los colores del formato de número anula cualquier color que el usuario haya ingresado en la celda, pero no anula los colores establecidos por el formato condicional. |
Ejemplos de formatos de número
En la siguiente tabla, se muestran algunos ejemplos de patrones y su correspondiente renderización de números con formato:
| Número | Patrón | Valor con formato |
|---|---|---|
| 12345.125 | ####.# |
12345.1 |
| 12.34 | 000.0000 |
012.3400 |
| 12 | #.0# |
12.0 |
| 5.125 | # ???/??? |
5 1/8 |
| 12000 | #,### |
12,000 |
| 1230000 | 0.0,,"M" |
1.2 M |
| 1234500000 | 0.00e+00 |
1.23e+09 |
| 123114.15115 MiTexto |
###0.000;"TEXT: "_(@_) |
123114.151 TEXT: MyText |
| 1234 -1234 0 MiTexto |
[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) |
1,234 1,234 0.0 MyText |
| 1005 32 527 |
[>1000]"HIGH";[Color43][<=200]"LOW";0000 |
ALTA BAJA 0527 |