Fecha, hora, número y otros aspectos de formato

Representa el día del mes como número de 1 a 31: 27.

Se da formato a un día con un solo dígito sin un cero a la izquierda: 3.

Si se usa solo, prefíjelo con %.

Representa el día del mes como un número de dos dígitos del 01 al 31: 27.

Se da formato a un día de un solo dígito con un cero a la izquierda: 03.

Representa el mes como número de 1 a 12: 11.

Se da formato a un mes con un solo dígito sin un cero a la izquierda: 5.

Si se usa solo, prefíjelo con %.

Representa el mes como número de dos dígitos del 01 al 12: 11.

Se da formato a un mes con un solo dígito con un cero a la izquierda: 05.

Representa el año como un número de uno o dos dígitos: 23.

Si el año tiene más de dos dígitos, sólo los dos dígitos de orden inferior aparecerán en el resultado. Por ejemplo, dado el año 2023, aparece 23.

Si el primer dígito de un año de dos dígitos comienza con un cero (por ejemplo, 02), se formatea el número sin un cero a la izquierda: 2.

Representa el año como un número de dos dígitos: 23.

Si el año tiene más de dos dígitos, sólo los dos dígitos de orden inferior aparecerán en el resultado. Por ejemplo, dado el año 2023, aparece 23.

Si el año de dos dígitos tiene menos de dos dígitos significativos, el número se completa con ceros iniciales hasta alcanzar los dos dígitos: 02.

Si se usa solo, prefíjelo con %.

Representa el año con un mínimo de tres dígitos: 2023.

Si el año tiene más de tres dígitos significativos, se incluyen en la cadena de resultado. Si el año tiene menos de tres dígitos, el número se completa con ceros a la izquierda para alcanzar los tres dígitos.

Nota: En el calendario budista tailandés, que puede años de cinco dígitos, este especificador de formato muestra los cinco dígitos.

Representa el año como un número de cuatro dígitos: 2023.

Si el año tiene más de cuatro dígitos, sólo los cuatro dígitos de orden inferior aparecerán en el resultado. Si el año tiene menos de cuatro dígitos, el número se completa con ceros a la izquierda para alcanzar los cuatro dígitos.

Nota: En el calendario budista tailandés, que puede años de cinco dígitos, este especificador de formato muestra los cinco dígitos.

Representa el año como un número de cinco dígitos.

Si el año tiene más de cinco dígitos, sólo los cuatro dígitos de orden inferior aparecerán en el resultado. Si el año tiene menos de cinco dígitos, se rellena el número con ceros a la izquierda para alcanzar los cinco dígitos: 02023.

Si hay más de cinco especificadores y , se rellena el número con tantos ceros a la izquierda como sea necesario para conseguir el número de especificadores y. Por ejemplo, si hay ocho especificadores y, el resultado es 00002023.

Representa el período o era, como A.D. El script ignora este especificador si la fecha a formatear no tiene un período asociado ni una cadena de era.

No se puede utilizar solo un g único. Si desea generar solo el nombre de la era o período, use un gg doble.

Representa la hora como un número del 1 al 12 en un reloj de 12 horas que cuenta las horas completas desde la medianoche o el mediodía.

Una hora determinada después de medianoche es indistinguible de la misma hora después del mediodía. Por ejemplo, la 1:00 a. m. es lo mismo que la 1:00 p. m.

La hora no se redondea, y una hora con un solo dígito se formatea sin un cero a la izquierda.

Si se usa solo, prefíjelo con %.

Por ejemplo, dada una hora de 5:43, este especificador de formato personalizado muestra 5.

Representa la hora como un número de dos dígitos del 01 al 12 en un reloj de 12 horas que cuenta las horas completas desde la medianoche o el mediodía.

Una hora determinada después de medianoche es indistinguible de la misma hora después del mediodía. Por ejemplo, la 1:00 a. m. es lo mismo que la 1:00 p. m.

La hora no se redondea, y una hora con un solo dígito se formatea sin un cero a la izquierda.

Por ejemplo, dada una hora de 5:43, este especificador de formato personalizado muestra 05.

Representa la hora como un número del 0 al 23 en un reloj de 24 horas que cuenta las horas desde la medianoche.

Una hora de un solo dígito se formatea sin un cero a la izquierda.

Por ejemplo, dada una hora de 17:43, este especificador de formato personalizado muestra 17.

Si se usa solo, prefíjelo con %.

Representa la hora como un número de dos dígitos del 00 al 23 en un reloj de 24 horas que cuenta las horas desde la medianoche.

Una hora de un solo dígito se formatea con un cero a la izquierda.

Por ejemplo, dada una hora de 17:43, este especificador de formato personalizado muestra 17.

Representa el minuto como un número del 0 al 59.

El minuto representa los minutos completos que han pasado desde la última hora. Un minuto de un solo dígito se formatea sin un cero a la izquierda.

Por ejemplo, dada una hora de 05:43, este especificador de formato personalizado muestra 43.

Si se usa solo, prefíjelo con %.

Representa el minuto como un número de dos dígitos del 00 al 59.

El minuto representa los minutos completos que han pasado desde la última hora. Un minuto de un solo dígito se formatea con un cero a la izquierda.

Por ejemplo, dada una hora de 05:03, este especificador de formato personalizado muestra 03.

Representa los segundos como un número del 0 al 59.

El resultado representa los segundos completos que han pasado desde el último minuto. Un segundo de un solo dígito se formatea sin un cero a la izquierda.

Por ejemplo, dada una hora de 05:43, este especificador de formato personalizado muestra 4.

Si se usa solo, prefíjelo con %.

Representa los segundos como número de dos dígitos del 00 al 59.

El resultado representa los segundos completos que han pasado desde el último minuto. Un segundo de un solo dígito se formatea con un cero a la izquierda.

Por ejemplo, dada una hora de 05:43, este especificador de formato personalizado muestra 04.

Representa un número de dígitos de la fracción de segundos. Los especificadores f en minúsculas incluyen los ceros finales. Los especificadores F en mayúsculas omiten los ceros finales.

Únicamente funciona este especificador con fechas/horas de automatización OLE Una forma de escribir fechas como un entero de coma flotante. Indica el número de días transcurridos desde el 30 de diciembre de 1899..

El número de caracteres f o F incluidos determina cuántos dígitos significativos se incluirán de la segunda fracción:

• F: Décimas de segundo o el dígito más significativo. Si el dígito es cero, no se muestra nada.
• ff o FF: Centésimas de segundo o dos dígitos significativos.
• fff o FFF: Milésimas de segundos, o tres dígitos significativos. Esto también se llama milisegundos.
• ffff o FFFF: Diezmilésimas de segundo o cuatro dígitos significativos.
• fffff o FFFFF: Cienmilésimas de segundo, o cinco dígitos significativos.
• ffffff o FFFFFF: Millonésimas de segundo, o seis dígitos significativos.
• FFFFFFF: Diezmillonésimas de segundo o siete dígitos significativos.

Cuanta más precisión especifique, menos confiable o significativa será. La precisión del valor de la hora depende de la resolución del reloj del sistema de cómputo.

Representa el primer carácter del designador a. m. /p. m. El designador AM se utiliza si la hora al momento de ser formateado es menor que 12. De lo contrario, se usa el designador PM.

en los idiomas que utilizan una designación a. m./p. m. donde es el mismo el primer carácter y cambia el segundo, utilice el especificador tt.

Si se usa solo, prefíjelo con %.

Representa el designador a. m./p. m. El designador AM se utiliza si la hora al momento de ser formateado es menor que 12. De lo contrario, se usa el designador PM.

Use el especificador tt en idiomas como el japonés que utilizan un designador a. m./p. m. donde el primer carácter es el mismo y cambia el segundo.

Representa la compensación oficial de la zona horaria del sistema operativo local respecto de la Hora Universal Coordinada (UTC). El número de caracteres z define cuánta compensación se mostrará:

• z, zz: Mide la compensación en horas.
• zzz: Mide la compensación en horas y minutos.

El desplazamiento se muestra siempre con un signo a la izquierda. Un signo más (+) indica las horas por delante y un signo menos (-) indica las horas detrás de la hora UTC. El desplazamiento va de -12 a +13. Un desplazamiento de un solo dígito se formatea con un cero a la izquierda.

Si se usa solo, prefíjelo con %.

El número se convierte en una cadena que representa una cantidad de moneda. Incluya un número con el especificador de formato para indicar la cantidad de decimales que desee que tenga el número. El caso del especificador de formato no afecta los resultados.

ASSIGN StringVal = "0013001.93912837"
ASSIGN CurrencyResult = "{StringVal.format('C')}"
ASSIGN CurrencyResult3 = "{StringVal.format('C3')}"

Resultado:

CURRENCYRESULT=$13,001.94

CURRENCYRESULT3=$13,001.939

E0

E-0

e0

e+0

e-0

Se convierte el número en una cadena de la forma -d.ddd…E+ddd o -d.ddd…e+ddd, donde cada d indica un dígito (0-9). La cadena comienza con un signo menos si el número es negativo. Un dígito siempre precede al punto decimal.

Incluya un número con el especificador de formato para indicar el número de dígitos que desee después del punto decimal. Si no incluye el especificador de precisión, el script tiene de manera predeterminada seis decimales.

Las mayúsculas o minúsculas del especificador de formato indica si el exponente en la salida tiene el prefijo con un E o un e. El exponente siempre consta de un signo más o menos y un mínimo de tres dígitos. El exponente se rellena con ceros para cumplir este mínimo, si es necesario.

Si alguna de las cadenas E, E+, E-, e, e+ o e- están presentes en la cadena de formato y van seguidas inmediatamente por al menos un carácter 0, entonces se da formato al número utilizando notación científica con una E o e insertada entre el número y su exponente.

El número de caracteres 0 tras el indicador de notación científica determina el número mínimo de dígitos de salida para el exponente. Los formatos E+ y e+ indican que siempre debe preceder al exponente un carácter de signo (más o menos). Los formatos E, E-, eo e- indican que un carácter de signo únicamente debe preceder a los exponentes negativos.

 ASSIGN StringVal = "0013001.93912837"
ASSIGN ScientificResult = "{StringVal.format('e')}"		
ASSIGN ScientificResult = "{StringVal.format('E2')}"	

Resultado:

SCIENTIFICRESULT=1.300194e+004

SCIENTIFICRESULT2=1.300194E+004

Se convierte el número en una cadena de la forma -ddd.ddd…, donde cada d indica un dígito (0-9). La cadena comienza con un signo menos si el número es negativo.

Incluya un número con el especificador de formato para indicar cuántos lugares decimales desea que tenga el resultado. Sin el indicador de precisión, el script tiene predeterminados dos decimales.

ASSIGN StringVal = "0013001.93912837"
ASSIGN FixedPointResult = "{StringVal.format('F3')}"
ASSIGN FixedPointResult2 = "{StringVal.format('f')}"

Resultado:

FIXEDPOINTRESULT=13001.939

FIXEDPOINTRESULT2=13001.94

Se convierte el número en la notación más compacta ya sea de punto fijo o científica, dependiendo del tipo de número y si se incluye un especificador de precisión. Si se omite o es cero el especificador de precisión , el tipo de número determina la precisión predeterminada, según lo indica la siguiente lista:

• Byte o SByte: 3
• Int16 o Uint16: 5
• Int32 o UInt32: 10
• Int64 o UInt64: 19
• Sencillo: 7
• Doble: 15
• Decimal: 29

La notación de punto fijo se utiliza si el exponente que resultaría de expresar el número en notación científica es mayor que 5 y menor que el especificador de precisión; de lo contrario, se utiliza la notación científica. El resultado contiene un punto decimal si es necesario y los ceros a la derecha se omiten.

Si el especificador de precisión está presente y el número de dígitos significativos en el resultado supera la precisión especificada, entonces los dígitos a la derecha sobrantes se eliminan redondeando. La excepción a esta regla es si el número es un Decimal y se omite el especificador de precisión. En ese caso, la notación de punto fijo se usa siempre y se conservan los ceros a la derecha.

Si se utiliza la notación científica, se pone como prefijo el exponente del resultado con E, si el especificador de formato es G, o con e si el especificador de formato es g.

ASSIGN StringVal = "0013001.93912837"
ASSIGN GeneralResult1 = "{StringVal.format('G')}"
ASSIGN StringVal2 = 6002348902348890234.234432234
ASSIGN GeneralResult2 = "{StringVal2.format('G')}"

Resultado:

GENERALRESULT1=13001.93912837

GENERALRESULT2=6.00234890234889E+18

Este formato es compatible sólo con los tipos integrales. El número se convierte en una cadena de dígitos hexadecimales. El caso de el especificador de formato indica si se deben usar letras mayúsculas o minúsculas para los dígitos hexadecimales mayores que 9. Por ejemplo, utilice X para producir ABCDEF y x para producir abcdef.

El especificador de precisión indica el número mínimo de dígitos deseados en la cadena resultante. Si es necesario, el número se rellena con ceros a la izquierda para producir el número de dígitos dado por el especificador de precisión.

Se convierte el número en una cadena de la forma -d,ddd,ddd.ddd…, donde:

• De ser necesario, el signo menos ( - ) indica un símbolo de número negativo.
• Cada d representa un dígito (0-9).
• Una coma ( , ) indica un separador de miles entre grupos de números.
• El punto ( . ) indica un símbolo de punto decimal.

Incluya un especificador de precisión para indicar el número de lugares decimales que desee que tenga el resultado. Si no se incluye ningún especificador de precisión, el valor predeterminado son dos decimales. Si el número no incluye un punto decimal, se agrega .00 al número de salida.

ASSIGN StringVal = "0013001.93912837"
ASSIGN NumberResult = StringVal.format('N')
ASSIGN NumberResult2 = "{StringVal.format('n2')}"

Resultado:

NUMBERRESULT=13,001.94

NUMBERRESULT2=13,001.9391

Se convierte el número en una cadena que representa un porcentaje. El número convertido se multiplica por 100 con el fin de representarse como un porcentaje.

Incluya un especificador de precisión para indicar el número de lugares decimales que desee que tenga el resultado. Si no se incluye ningún especificador de precisión, el valor predeterminado son dos decimales. Si el número no incluye un punto decimal, se agrega .00 al número de salida.

ASSIGN StringVal = "0013001.93912837"
ASSIGN PercentResult = "{StringVal.format('P')}"
ASSIGN PercentResult2 = StringVal.format('P2')	

Resultado:

PERCENTRESULT=1,300,193.91%

PERCENTRESULT2=1,300,193.91%

Este formato es compatible sólo con los tipos Simple y Doble El especificador de redondeo garantiza que un valor numérico convertido a una cadena será analizado dentro del mismo valor numérico. Cuando un valor numérico se formatea utilizando este especificador, primero se prueba usando el formato general, con 15 espacios de precisión para un Doble y 7 espacios de precisión para un Simple. Si el valor se analiza correctamente al mismo valor numérico, se formatea utilizando el especificador de formato general. Sin embargo, si el valor no se analiza correctamente al mismo valor numérico, luego el valor se formatea usando 17 dígitos de precisión para un Doble y 9 dígitos de precisión para un Simple.

Aunque un especificador de precisión puede estar presente, se le ignora. Al redondeado se le da precedencia sobre la precisión cuando se usa este especificador.

ASSIGN StringVal = "0013001.93912837"
ASSIGN RoundTripResult = "{StringVal.format('R')}"	

Resultado:

ROUNDTRIPRESULT=13001.93912837

Utilice uno o más marcadores de posición cero para definir el formato de los números en la salida. Puede combinar este marcador de posición con los demás caracteres de marcador de posición que se definen en esta tabla.

Si el valor al que se está dando formato tiene un número en la posición donde aparece un 0 en la cadena de formato, ese número aparece en la cadena de salida. Si no aparece ningún número en la posición donde aparece un 0 en la cadena de formato, aparece 0 en la cadena de salida. Esto puede resultar útil para sumar ceros a un número que necesita ceros a la izquierda pero que no los tiene.

La posición del 0 más a la izquierda antes del punto decimal y el 0 más a la derecha después del punto decimal determinan el número de dígitos que están siempre presentes en la cadena de salida.

El especificador 00 hace que se redondee el valor al número entero más cercano.

ASSIGN number = "2343456.2343"
ASSIGN zeroPlaceholders = "number.format(000,000.00)
ASSIGN number = "456.47"
ASSIGN doubleZeroSpecifier = number.format('00')

El resultados del ejemplo son

zeroPlaceholders = 2,343,456.23

doubleZeroSpecifier = 456

Utilice uno o más marcadores de posición de dígitos para definir el formato de los números en la salida. Puede combinar este marcador de posición con los demás caracteres de marcador de posición que se definen en esta tabla.

Si el valor al que se está dando formato tiene un número en la posición donde aparece un # en la cadena de formato, dicho número aparece en el resultado saliente. Si no aparece ningún número en la posición donde aparece un # en la cadena de formato, en la cadena de salida estará vacío ese lugar.

Si el número al que se le da formato contiene un 0 como dígito significativo, el 0 aparece en la cadena de salida. Si el 0 no es un dígito significativo, no aparece en la cadena de salida, incluso si 0 es el único número de la cadena al que se le va a dar formato.

La cadena de formato ## hace que se redondee el valor al número entero más cercano.

ASSIGN number = "2343456.2043"
ASSIGN digitPlaceholders = "number.format(###,###.##)
ASSIGN number = "456.47"
ASSIGN doubleDigitSpecifier = number.format('##')

El resultados del ejemplo son

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

El primer punto ( . ) en la cadena de formato determina la ubicación del separador decimal en el valor formateado. Se ignoran los caracteres de punto adicionales.

El carácter de coma ( , ) sirve como un especificador separador de miles y especificador del escalado de los números.

Especificador de separador de miles: Si se especifica uno o más caracteres de coma ( , ) entre los marcadores de dos dígitos (0 o #) que dan formato a los dígitos integrales de un número, se inserta un carácter separador de grupo entre el grupo de números en la parte integral de la salida. Por ejemplo, si se usa la cadena #,# y cultura no variable para dar formato al número 1000, la salida es 1,000.

Especificador de escalado de los números: Si se especifican uno o más caracteres de coma ( , ) inmediatamente a la izquierda del punto decimal explícito o implícito, se divide entre 1000 el número al que se le dará formato por cada especificador de escalado de números. Por ejemplo, si se usa la cadena 0,, para dar formato al número 100 millones, la salida es 100.

Puede usar separador de miles y el número de especificadores de escala de números en la misma cadena de formato. Por ejemplo, si se usa la cadena #,0,, y cultura no variable para dar formato al número mil millones, la salida es 1,000.

Le permite definir dos o tres posibles opciones de formato para los números. Se aplica el formato dependiendo de si el número es positivo, negativo o cero.

Se definen en una sola cadena las opciones de formato. Se separa cada opción con un carácter de punto y coma ( ; ). Utilice los marcadores de posición cero, dígito, miles y decimales para definir el formato, según se muestra en los ejemplos siguientes. En esta tabla se describen estos marcadores de posición.

Si hay dos secciones en la cadena de formato personalizado:

• La sección a la izquierda define el formato de los números positivos y el cero.
• La sección a la derecha define el formato de los números negativos.

Por ejemplo:

ASSIGN number9 = 928374
ASSIGN sectionSeparator4 = number9.format('000,000.##;00.##')

ASSIGN number10 = -998822.25
ASSIGN sectionSeparator5 = number10.format('000,000.##;00.##')

ASSIGN number11 = 0
ASSIGN sectionSeparator6 = number11.format('000,000.##;00.##')	

El resultados del ejemplo son

sectionSeparator4 = 928,374

sectionSeparator5 = 998822.25

sectionSeparator6 = 000,000

Si hay tres secciones:

• La sección a la izquierda define el formato de los números positivos.
• La sección media define el formato de los números negativos.
• La sección a la derecha define el formato de los números cero.

Por ejemplo:

ASSIGN number1 = 1789789
ASSIGN sectionSeparator1 = number1.format('000,000.##;00.##;000.0000')

ASSIGN number2 = 0
ASSIGN sectionSeparator2 = number2.format('000,000.##;00.##;000.0000')

ASSIGN number3 = -4321
ASSIGN sectionSeparator3 = number3.format('000,000.##;00.##;000.0000')

El resultados del ejemplo son

sectionSeparator1 = 1,789,789

sectionSeparator2 = 000.0000

sectionSeparator3 = 4321

Todos los demás caracteres

Cualquier otro caracter se copian a la cadena de resultado, y no afecta al formateo.

Se utiliza para anteponer una cadena que incluye una secuencia de escape. El carácter $ debe estar fuera de las comillas dobles. Por ejemplo:

z = $"Use the \{myVar} variable."

Úselo para anteponer un valor para declararlo como un tipo de fecha/hora. El carácter # debe estar fuera de las comillas dobles. Por ejemplo:

ASSIGN var = #"02/09/2023"