Fecha, hora, Número y otros Formatting

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, antepóngale %.

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, antepóngale %.

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 menor orden 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 menor orden 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, antepóngale %.

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 menor orden 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 menor orden aparecen en el resultado. Si el año tiene menos de cinco dígitos, el número se completa con ceros a la izquierda para alcanzar los cinco dígitos: 02023.

Si hay más de cinco especificadores y, el número se completa con tantos ceros a la izquierda como sean necesarios para alcanzar la cantidad de especificadores 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 mostrar 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 AM 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 AM es lo mismo que 1:00 PM.

La hora no se redondea, y una hora con 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, dada una hora 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, dada una 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 transcurrido 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 transcurrido 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 segundos completos que han transcurrido 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 usa solo, agregue el prefijo %.

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

El resultado representa segundos completos que han transcurrido 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 en minúscula f incluyen los ceros finales. Los especificadores en mayúscula F omiten los ceros finales.

Únicamente funciona este especificador con fechas/horas de automatización OLE Una forma de escribir fechas como un número entero de punto 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 de la fracción de segundos 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 denomina milisegundos.
• ffff o FFFF: Diez milésimas de segundo o cuatro dígitos significativos.
• fffff o FFFFF: Cien milé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.

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

Representa el primer carácter del designador a. m./PM. El designador a. m. se usa si la hora en el valor de hora que se está dando formato es menor que 12. De lo contrario, se usa el designador PM.

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

Si se usa solo, anteponga %.

Representa el designador a. m./PM. El designador a. m. se usa si la hora en el valor de hora que se está dando formato es menor de 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./PM donde el primer carácter es el mismo y cambia el segundo.

Representa el desplazamiento con signo de la zona horaria del sistema operativo local respecto al Tiempo Universal Coordinado (UTC). El número de caracteres z define cuánto del desplazamiento se mostrará:

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

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

Si se usa solo, anteponga %.

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 lugares decimales que desea que tenga el número. El uso de mayúsculas o minúsculas en el 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 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. Siempre precede un dígito al punto decimal.

Incluya un número con el especificador de formato para indicar la cantidad de dígitos que desea después del punto decimal. Si no incluye el especificador de precisión, el script usa de forma predeterminada seis lugares decimales.

El uso de mayúsculas o minúsculas en el especificador de formato indica si el exponente en la salida tiene el prefijo de E o de 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 caracter 0, entonces el número se formatea usando notación científica con un E o e insertado entre el número y el exponente.

La cantidad de caracteres 0 que siguen al indicador de notación científica determina la cantidad mínima de dígitos a mostrar para el exponente. Los formatos E+ y e+ indican que un caracter de signo (más o menos) siempre debe preceder al exponente. Los formatos E, E-, e o e- indican que un caracter de signo solo 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 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 usa de forma predeterminada dos lugares 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 el especificador precision 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
• Single: 7
• Double: 15
• Decimal: 29

Se usa la notación de punto fijo 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 usa 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 excede la precisión especificada, los dígitos finales en exceso se eliminan mediante redondeo. 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 la notación científica, el exponente en el resultado tiene el prefijo E si el especificador de formato es G, o 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 se admite solo para tipos integrales. El número se convierte en una cadena de dígitos hexadecimales. El tipo de letra (mayúscula o minúscula) del especificador de formato indica si se deben usar caracteres en mayúscula o minúscula 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

El número se convierte 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 solo con los tipos Single y Double. El especificador de ida y vuelta garantiza que un valor numérico convertido en una cadena se analizará nuevamente para obtener el 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 como el 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 como el 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 puede estar presente un especificador de precisión, se 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 definidos en esta tabla.

Si el valor al que se le da 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, 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 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')

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 demás caracteres de marcador de posición definidos en esta tabla.

Si el valor al que se le da formato 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 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 el 0 es el único número en la cadena a la que se le debe 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('##')

Los resultados del ejemplo son:

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

El primer caractere de punto ( . ) en la cadena de formato determina la ubicación del separador decimal en el valor con formato. Cualquier caractere de punto adicional es ignorado.

El caractere de coma ( , ) sirve tanto como especificador de separador de miles como especificador de escala de número.

Especificador de separador de miles: Si se especifica uno o más caracteres de coma ( , ) entre dos marcadores de posición de dígito (0 o #) que dan formato a los dígitos enteros de un número, se inserta un caractere separador de grupo entre cada grupo de números en la parte entera 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 escala de Número: 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 al que se le dará formato se divide entre 1000 por cada especificador de escala de número. 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 usan 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 opciones de formato posibles para números. Se aplica el formato dependiendo de si el número es positivo, negativo o cero.

Las opciones de formato se definen en una sola cadena. Cada opción se separa mediante un caractere 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. Estos marcadores de posición se describen en esta tabla.

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 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')

Los resultados del ejemplo son:

sectionSeparator1 = 1,789,789

sectionSeparator2 = 000.0000

sectionSeparator3 = 4321

Todos los demás caracteres

Cualquier otro carácter se copia a la cadena de resultado, y no afecta al formateo.

Úselo para anteponer a una cadena que incluya una secuencia de escape. El carácter $ debe estar fuera de las comillas dobles. Por ejemplo:

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

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

ASSIGN var = #"02/09/2023"