Altova MapForce 2025 Enterprise Edition

Convierte un valor de fecha y hora (xs:dateTime) en una cadena de texto. La representación de cadena de la fecha y hora sigue el formato que dicte el valor del argumento format

Lenguajes

Built-in, C++, C#, Java, XSLT 2.0, XSLT 3.0.

Parámetros

Formato

El argumento format consiste en una cadena que contiene marcadores de variables entre corchetes (por ejemplo, [Y]/[M]/[D]). Los caracteres situados fuera de los corchetes son caracteres literales que se deben copiar en el resultado. Si necesita usar corchetes como caracteres literales en el resultado, escríbalos dos veces.

Cada marcador de variable consta de las siguientes partes:

•un especificador que identifica qué parte del tipo de datos debe mostrarse (es decir, la fecha o la hora),

•un modificador de formato opcional,

•un modificador de presentación opcional, y

•un modificador del ancho opcional, que debe ir precedido de una coma si está presente.

Especificadores

Los especificadores disponibles se describen en la tabla siguiente.

Modificadores de formato

El modificador de formato puede ser cualquiera de estos:

Nota importante

los modificadores N, n y Nn solamente son compatibles con estos especificadores: M, F y P. Los modificadores N, n y Nn también son compatibles con el especificador z, pero solo en el lenguaje de transformación Built-in y en la generación de código (Professional y Enterprise Edition).

Si necesita un modificador del ancho, antepóngale una coma. El modificador del ancho es un dígito que expresa el ancho mínimo. Opcionalmente, puede agregar un guion y un dígito que exprese el ancho máximo. Por ejemplo:

•[D,2] es el día del mes, con ceros a la izquierda (dos dígitos).

•[MNn,3-3] es el nombre del mes, escrito con tres caracteres, por ejemplo, Ene, Feb, Mar, etc.

Ejemplos

La tabla siguiente muestra algunos ejemplos de formato de valores xs:dateTime, obtenido con ayuda de la función format-dateTime. La columna Valor de la tabla especifica el valor dado al argumento value. La columna Formato de la tabla especifica el valor del argumento format. La columna Resultado muestra qué devuelve la función.