Fecha, hora, número y otro 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, agregue el prefijo %.

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 lo usa solo, agregue el prefijo %.

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, solo los DOs dígitos de orden inferior aparecen 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, solo los DOs dígitos de orden inferior aparecen 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, agregue el prefijo %.

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, estos 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, solo los cuatro dígitos de orden inferior aparecen 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, solo los cinco dígitos de orden inferior aparecen 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 que cinco especificadores de y, el número se rellena con tantos ceros a la izquierda como sean necesarios para alcanzar el número de especificadores de y. Por ejemplo, si hay ocho especificadores y, la salida 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.

Un solo g no se puede usar solo. Si desea generar como salida solo el nombre de la era o período, use un doble gg.

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, 1:00 a. m. es lo mismo que 1:00 PM.

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, agregue el prefijo %.

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, 1:00 a. m. es lo mismo que 1:00 PM.

La hora no está redondeada, y una hora de un solo dígito se formatea con 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, dado un valor de tiempo de 5:43 PM, este especificador de formato personalizado muestra 17.

Si se usa solo, agregue el prefijo %.

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, dado un valor de hora de 5:43 PM, 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 5:43:34, este especificador de formato personalizado muestra 43.

Si se usa solo, agregue el prefijo %.

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 5:03:34, 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 5:43:04, este especificador de formato personalizado muestra 4.

Si se utiliza solo, agregue el prefijo %.

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 5:43:04, 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úscula omiten los ceros finales.

Únicamente funciona este especificador con fechas/horas de automatización OLE A way to write dates as a floating point integer. Indicates the number of days since December 30, 1899..

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

• 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 segundo, 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: Diez millonésimas de segundo, o siete dígitos significativos.

Mientras más precisión especifique, menos confiable o significativa puede ser. La precisión del valor de tiempo depende de la resolución del reloj del sistema de la computadora.

Representa el primer carácter del designador AM/PM. 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.

Para los idiomas que utilizan una designación AM/PM en la que el primer carácter es igual y el segundo carácter cambia, utilice el especificador tt.

Si se usa solo, agregue el prefijo %.

Representa el designador AM/PM. 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 AM/PM donde el primer carácter es el mismo y el segundo carácter cambia.

Representa el desplazamiento con signo de la zona horaria del sistema operativo local respecto al tiempo Universal Coordinado (UTC). La cantidad de caracteres z define cuánto desplazamiento mostrar:

• z, zz: mide el desplazamiento en horas.
• : Mide el desplazamiento en horas y minutos.

El desplazamiento siempre se muestra con un signo inicial. Un signo más (+) indica horas adelante de UTC y un signo menos (-) indica horas atrás de UTC. El desplazamiento varía de –12 a +13. Un desplazamiento de un solo dígito se formatea con un cero inicial.

Si se usa solo, agregue el prefijo %.

El número se convierte en una cadena que representa un importe en 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

El número se convierte a una cadena con el formato -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.

El tipo de letra del especificador de formato indica si el exponente en la salida está precedido por una E o una 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á presente en la cadena de formato y va seguida inmediatamente de al menos un carácter 0, entonces el número se formatea utilizando notación científica con un E o e insertado entre el número y el exponente.

El número de 0 caracteres que siguen al indicador de notación científica determina la cantidad mínima de dígitos que se mostrarán como 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

El número se convierte en una cadena con el formato -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

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

• Byte o SByte: 3
• Int16 o UInt16: 5
• Int32 o UInt32: 10
• Int64 o UInt64: 19
• Único: 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 usa notación científica, el exponente en el resultado tiene el prefijo 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 solo se admite para 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, use 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.

El número se convierte en una cadena con el formato -d,ddd,ddd.ddd…, donde:

• El signo menos ( - ) indica un símbolo de número negativo si es necesario.
• 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 solo se admite para los tipos Single y Double. El especificador de ida y vuelta garantiza que un valor numérico convertido a una cadena se analizará de nuevo al mismo valor numérico. Cuando se da formato a un valor numérico utilizando este especificador, primero se prueba utilizando el formato general, con 15 espacios de precisión para un Double y 7 espacios de precisión para un Single. Si el valor se analiza correctamente de nuevo al mismo valor numérico, se le da formato utilizando el especificador de formato general. Sin embargo, si el valor no se analiza correctamente de nuevo al mismo valor numérico, entonces se le da formato al valor utilizando 17 dígitos de precisión para un Double y 9 dígitos de precisión para un Single.

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

Use uno o más marcadores de posición de 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 definidos en esta tabla.

Si el valor que se está formateando 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, en su lugar aparece un 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 siempre están presentes en la cadena de salida.

El especificador 00 hace que el valor se redondee 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')

Los 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 otros caracteres de marcador de posición definidos en esta tabla.

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

Si el número que se está formateando 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 el 0 es el único número en la cadena que se va a formatear.

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

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

Los resultados del ejemplo SOn:

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

El carácter ) 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 ( , ) funciona tanto como especificador de separador de miles como especificador de escala numérica.

Especificador de separador de miles: Si se especifica uno o más caracteres de coma ( , ) entre DOs marcadores de posición de 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 cada grupo numérico de la parte integral de la salida. Por ejemplo, si se usan la cadena #,# y la referencia cultural invariable para dar formato al número 1000, la salida es 1,000.

Especificador de escala numérica: Si se especifica uno o más caracteres de coma ( , ) inmediatamente a la izquierda del punto decimal explícito o implícito, el número que se va a formatear se divide entre 1000 por cada especificador de escala numérica. Por ejemplo, si la cadena 0,, se usa para formatear el 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 utilizan la cadena #,0,, y la referencia de cultura, se da formato al número mil millones, y 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.Cada opción está separada por 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.##')	

Los resultados de este 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')

Los resultados de este 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."

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

ASSIGN var = #"02/09/2023"