Marcadores de posición con definición de formato
El texto de salida de un elemento puede mostrar el valor de una variable por medio de un marcador de posición (%
) con una definición de formato. Cuando se muestra el texto, se inserta el valor de la variable en lugar del marcador de posición. El tipo de datos en la definición de formato y en la variable deben ser idénticos.
La cadena mostrada se enumera en la Variable de texto propiedad.
Propiedad del elemento. La variable se incluye en laLos usuarios de visualización pueden especificar un texto en un elemento, en el que el texto, por ejemplo, se almacena y se muestra como una variable de salida de texto. La entrada del usuario debe corresponder al formato de entrada. El tipo de datos de la variable de salida de texto debe corresponder al tipo de datos definido para el formato de entrada.
La definición del formato para el texto de entrada se encuentra en el Configuración de entrada diálogo, en Entrada de texto, en el Escribir variable Acción de entrada. La variable se incluye en la lista. Variable de texto propiedad.
Entero
La definición de formato para un entero tiene el siguiente formato:
% <banderas> <número mínimo de dígitos> <tipo>
Tipos de datos recomendados: BYTE | WORD | DWORD | LWORD | SINT | USINT | INT | UINT | DINT | UDINT | LINT | ULINT
Sintaxis | Ejemplo | Descripción | Ejemplo en visualización |
---|---|---|---|
<banderas> | Opcional y combinable | Código: Variable de texto propiedad: | |
|
| Alineación justificada a la izquierda, respecto del ancho mínimo del número (especificado en número mínimo de dígitos) | Texto propiedad: |
|
| Salida siempre con signo | Texto propiedad: Producción: |
|
| Los lugares se rellenan con un 0 hasta que se alcanza el número mínimo de lugares (incluido el signo) | Texto propiedad: |
<número mínimo de dígitos> |
| Opcional Número mínimo de plazas |
Sintaxis | Ejemplo | Descripción | Ejemplo en visualización |
---|---|---|---|
<tipo> | Requerido | ||
|
| Salida como un número decimal entero | Código: Texto propiedad: Variable de texto propiedad: Producción: |
| Código: Texto propiedad: Variable de texto propiedad: Producción: | ||
|
| Salida como número binario entero sin signo y sin prefijo | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Salida como número octal entero sin signo y sin prefijo | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Salida como un número hexadecimal de 32 bits sin signo con los dígitos a–f (minúsculas) sin prefijo y sin separador | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Salida como un número hexadecimal de 32 bits sin signo con los dígitos A–F (mayúsculas) sin prefijo y sin separador | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Salida como un número hexadecimal de 64 bits sin signo con los dígitos a–f (minúsculas) sin prefijo y sin separador Nota: Tipos de datos recomendados: | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Salida como un número hexadecimal de 64 bits sin signo con los dígitos A–F (mayúsculas) sin prefijo y sin separador Tipos de datos recomendados: | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Salida como un número decimal entero sin signo Tipos de datos recomendados: | Código: Texto propiedad: Variable de texto propiedad: Producción: |
Número de punto flotante en notación de punto fijo
Los números de punto flotante se pueden mostrar como un número decimal en notación de punto fijo. La definición de formato para esto tiene el siguiente formato:
% <banderas> <número mínimo de dígitos> . <precisión> f
Tipos de datos recomendados para este tipo de variable de marcador de posición: REAL | LREAL
Sintaxis | Ejemplo | Descripción | Ejemplo en visualización |
---|---|---|---|
<banderas> | Opcional y combinable | ||
|
| Alineación justificada a la izquierda, respecto al número mínimo de dígitos | |
|
| Siempre con signo, también para números positivos | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Los lugares se rellenan con un 0 hasta que se alcanza el número mínimo de lugares (incluido el signo y el punto decimal). | Código: Texto propiedad: Variable de texto propiedad: Salida: |
<número mínimo de dígitos> . <precisión> | Opcional Cuando no se especifica, el número se muestra en formato estándar 1.6 | ||
<número mínimo de dígitos> |
| Número mínimo de lugares incluyendo el signo y el punto decimal Ejemplo: 12 | Código: Texto propiedad: Variable de texto propiedad: Salida: |
<precisión> |
| Precisión en los lugares y el punto decimal Ejemplo: 3 | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Requerido Identificador de formato para visualización decimal con punto decimal | Código: Texto propiedad: Variable de texto propiedad: Producción: |
Número de coma flotante en notación exponencial
Los números de punto flotante se pueden mostrar en notación exponencial estandarizada con base 10. La definición de formato para la notación exponencial tiene el siguiente formato:
% <banderas> <número mínimo de dígitos> . <precisión> <tipo>
Tipos de datos recomendados para este tipo de variable de marcador de posición: REAL | LREAL
Sintaxis | Ejemplo | Descripción | Ejemplo en visualización |
---|---|---|---|
<banderas> | Opcional y combinable | ||
|
| Alineación justificada a la izquierda, respecto al número mínimo de dígitos | |
|
| Siempre con signo, también para números positivos | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Los lugares se rellenan con un 0 hasta que se alcanza el número mínimo de lugares (incluido el signo y el punto decimal). | Código: Texto propiedad: Variable de texto propiedad: Producción: |
<número mínimo de dígitos> . <precisión> | Opcional Cuando no se especifica, la mantisa se emite en formato estándar 1.6 | ||
<número mínimo de dígitos> |
| Número mínimo de lugares, incluido el signo (para mantisa y exponente), el punto decimal y los exponentes ( Ejemplo: 12 | Código: Texto propiedad: Variable de texto propiedad: Producción: |
<precisión> |
| Precisión de la mantisa en los lugares y el punto decimal Ejemplo: 3 | Código: Texto propiedad: Variable de texto propiedad: Producción: |
<tipo> | Requerido | ||
|
| Pantalla con | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Pantalla con | Código: Texto propiedad: Variable de texto propiedad: Producción: |
Tiempo en números enteros
Aviso de compatibilidad
Para obtener la visualización habitual, en V3.5 SP17 y superiores, por regla general se utilizan tres dígitos para la salida de fracciones de segundo (ms/µs/ns). Ejemplo: En %t[dd-HH:mm:ss:ms]
, ms
Se especifica con tres dígitos para los milisegundos. Para ello, el número de ms de dos dígitos se antepone con un cero. Si se desea una salida de dos dígitos (como antes de V3.5 SP17), se debe configurar una definición de compilador especial en las propiedades del compilador de la aplicación: VISU_MILLISEC_NOLEADING_ZERO
.
Si el texto de salida en el %t
con una identificación para una unidad de tiempo, se genera una hora, una duración de tiempo o un intervalo de tiempo. La variable de marcador de posición se asigna en el Variable de texto propiedad.
El marcador de posición para un tiempo por unidad de tiempo tiene el siguiente formato:
%t[ <texto> <tiempo en unidad> <texto> ]
Tipos de datos recomendados: TIME
, LTIME
Sintaxis | Ejemplo | Descripción | Ejemplo en visualización |
---|---|---|---|
<tiempo en unidad> | Requerido Identificación de una unidad de tiempo Filtra a partir del valor de tiempo el número completo de la unidad de tiempo especificada (días, horas, minutos, segundos, milisegundos) Para valores de tiempo de 64 bits, también microsegundos y nanosegundos | ||
Válido para los siguientes ejemplos: Código: Variable de texto propiedad: | |||
|
| Número de días, sin cero antepuesto | Texto propiedad: Producción: |
|
| Número de días enteros, con un cero antepuesto | Texto propiedad: Producción: |
|
| Número de horas (0–23) | Texto propiedad: Producción: |
|
| Número de horas (00–23) | Texto propiedad: Producción: |
|
| Número de horas (0–23) | Texto propiedad: Producción: |
|
| Número de horas (00–23) | Texto propiedad: Producción: |
|
| Número de minutos (0–59), sin cero inicial | Texto propiedad: Producción: |
|
| Número de minutos (00–59), con cero inicial | Texto propiedad: Producción: |
|
| Número de segundos (00–59), sin cero inicial | Texto propiedad: Producción: |
|
| Número de segundos (00–59), con cero inicial | Texto propiedad: Producción: |
|
| Número de fracciones de segundo, en milisegundos (0–999) | Texto propiedad: Producción: |
|
| Número de fracciones de segundo, en microsegundos (0–999) Sólo para tipo de datos | Texto propiedad: Producción: Nota: Se permite el desbordamiento en la unidad de tiempo más grande de una definición. |
|
| Número de fracciones de segundo, en nanosegundos (0–999) Sólo para tipo de datos | Texto propiedad: Producción: Nota: Se permite el desbordamiento en la unidad de tiempo más grande de una definición. |
<texto> |
| Opcional Las cadenas, que se especifican entre corchetes, se incluyen en la salida. Nota: Si se debe generar una cadena que corresponde a una identificación para una unidad de tiempo o que contiene identificaciones para unidades de tiempo, la cadena debe estar entre comillas simples. | Texto propiedad: Producción: Texto propiedad: Producción: |
Dentro de los corchetes, las identificaciones de unidades de tiempo pueden aparecer cualquier cantidad de veces y pueden intercambiarse con cualquier cadena.
Sintaxis | Ejemplo | Descripción | Ejemplo en visualización |
---|---|---|---|
| Formato de hora para todas las unidades de tiempo, con el separador habitual entre ellas | Texto propiedad: Producción: | |
| Formato con cadenas adicionales que deben imprimirse, sin tener en cuenta las identificaciones de las unidades de tiempo Este tipo de cadenas se encierran entre comillas rectas simples. | Texto propiedad: Producción: |
El tiempo como un número decimal
Tipos de datos recomendados: TIME
, LTIME
En la definición del formato, la duración del tiempo <time in unit>
se puede identificar con la identificación del lugar decimal <number of decimal places>
El resultado es que la duración del tiempo se formatea como un número decimal (con decimales) en la unidad de tiempo especificada. Esto es posible para los siguientes formatos de tiempo: HH | H | hh | h| mm | m | ss | s | ms |us | ns
Esto puede ser útil para la entrada del usuario.
El marcador de posición para un período de tiempo como número decimal tiene el siguiente formato:
%t[ <tiempo en unidad> <número de decimales>]
Sintaxis | Ejemplo | Descripción | Ejemplo en visualización |
---|---|---|---|
<tiempo en unidad> | Requerido Identificación de una unidad de tiempo que formatea el valor de tiempo en la unidad de tiempo especificada (días, horas, minutos, segundos, milisegundos) como un número decimal Para valores de tiempo de 64 bits, también microsegundos y nanosegundos | ||
<número de decimales> | Requerido Número máximo de decimales ( Nota: Incluso si no se desean decimales para la entrada o visualización, al menos el número | ||
Los requisitos se aplican a los siguientes ejemplos: Código: Variable de texto propiedad: | |||
|
| Valor de tiempo (en horas) como número decimal Número de horas (0–23) Ejemplo: 4 | Texto propiedad: Entrada del usuario: Valor del tiempo: |
|
| Valor de tiempo (en minutos) como número decimal Ejemplo: 2 | Entrada del usuario: Valor del tiempo |
|
| Valor de tiempo (en segundos) como número decimal Ejemplo: 3 | Entrada del usuario: Valor del tiempo |
| Ejemplo: 0 | Entrada del usuario: Valor del tiempo | |
|
| Valor de tiempo (en milisegundos) como número decimal Ejemplo: 3 | Entrada del usuario: Valor del tiempo |
|
| Valor de tiempo (en microsegundos) como número decimal Ejemplo: 3 | Entrada del usuario: Valor del tiempo |
|
| Valor de tiempo (en nanosegundos) como número decimal Ejemplo: 0 | Entrada del usuario: Valor del tiempo |
Hora del sistema
Si una variable no está asignada a un marcador de posición con una definición de formato, se emite la hora del sistema.
Sintaxis | Ejemplo | Descripción | Ejemplo en visualización |
---|---|---|---|
|
| Salida de la hora actual del sistema Requisito: No La variable se especifica debajo de Variable de texto propiedad. | Texto propiedad: Variable de texto propiedad: en blanco Producción: |
|
| Opcional Salida del desfase horario del sistema local como hora universal (UTC) | Texto propiedad: Dependiendo de la variable UTC
|
Sugerencia
Puede cambiar mediante programación la zona horaria local del sistema a la hora universal (UTC).
Cuando la variable VisuElems.Visu_DateTime.DisplayUTC
está configurado para TRUE
, la hora del sistema se muestra como hora universal (UTC). De forma predeterminada, la variable VisuElems.Visu_DateTime.DisplayUTC
está configurado para FALSE
para que la hora del sistema se muestre en la zona horaria local.
Para mostrar valores de fecha y hora, puede ampliar la cadena de formato respectiva con el código de zona horaria. Z
Para una salida en la hora del sistema local, la diferencia se muestra en la hora universal (UTC). Por ejemplo, dd:MM:yyyy HH:mm:ss:ms:Z
Salidas 01.08.2021 12:00:00:001:+02:00
Cuando se muestra la hora universal (UTC), también se muestra el código UTC. 01.08.2021 10:00:00:001:Z
Fecha y hora
Aviso de compatibilidad
Para obtener la visualización habitual, en V3.5 SP17 y superiores, por regla general se utilizan tres dígitos para la salida de fracciones de segundo (ms/µs/ns). Ejemplo: En %t[dd-HH:mm:ss:ms]
, ms
Se especifica con tres dígitos para los milisegundos. Se antepone un cero a los dos dígitos. ms
número. Si se desea una salida de dos dígitos (como antes de V3.5 SP17), se debe configurar una definición de compilador especial en las propiedades del compilador de la aplicación: VISU_MILLISEC_NOLEADING_ZERO
.
Tipos de datos recomendados para definiciones de fecha y hora: DATE
, DATE_AND_TIME
, DT
, LDATE
, LDATE_AND_TIME
, LDT
, LTOD
, TIME_OF_DAY
, TOD
De forma predeterminada, los nombres de los días y meses se muestran en inglés. Cuando se utilizan textos localizados, el System
La lista de textos debe completarse. Esta lista de textos se crea automáticamente en el POU (Puntos de uso) ver cuando el %t
Se utiliza un marcador de posición. Aquí se deben utilizar los términos en inglés como identificadores. La localización se puede realizar tanto para los nombres abreviados como para los nombres completos.
La cadena de formato para una definición de fecha y hora tiene el siguiente formato:
%t[ <unidad de fecha y hora> ]
Sintaxis | Ejemplo | Descripción | Ejemplo en visualización |
---|---|---|---|
<unidad de fecha y hora> | Requerido Identificación de unidades de fecha y hora Filtra desde el valor de tiempo (tipo de datos: fecha y hora) el valor para la unidad especificada (año, mes, día, hora, minuto, milisegundos) Para valores de fecha y hora de 64 bits, también microsegundos y nanosegundos | ||
|
| Año con siglo | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Año sin siglo (00–99) | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Año sin siglo (0–99) | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Mes como nombre completo | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Mes como nombre abreviado | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Mes como número (01–12) | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Mes como número (1–12) | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Día de la semana como número (1 = lunes – 7 = domingo) | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Día de la semana como nombre completo | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Día de la semana como nombre abreviado | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Día del mes como número (01–31) | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Día del mes como número (1–31) | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Día del año como número (001–366) | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Hora en formato de 24 horas (00–23) Ejemplo
| Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Hora en formato de 12 horas (01–12) Ejemplo
| Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Abreviatura A o P en formato de 12 horas A para P para Ejemplo
| Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Abreviatura AM o PM en formato de 12 horas soy para Primer Ministro para Ejemplo
| Código: Texto propiedad: Variable de texto propiedad: Producción: |
Dentro de los corchetes, las identificaciones de las unidades de fecha y hora pueden aparecer cualquier cantidad de veces y pueden intercambiarse con cualquier cadena.
Sintaxis | Ejemplo | Descripción | Ejemplo en visualización |
---|---|---|---|
| Fecha y día de la semana con separadores entre ellos | Código: Texto propiedad: Variable de texto propiedad: Producción: | |
| Hora del día | Código: Texto propiedad: Variable de texto propiedad: Producción: | |
| Si se deben generar cadenas que corresponden a una definición de formato, estas deben representarse entre comillas simples. | Texto propiedad: Producción: |
Texto
Tipos de datos recomendados de la variable de marcador de posición: STRING
, WSTRING
La definición de formato para cadenas y cadenas tiene el siguiente formato:
% <tipo>
Sintaxis | Ejemplo | Descripción | Ejemplo en visualización |
---|---|---|---|
<tipo> | |||
|
| Salida de un solo carácter en el conjunto de caracteres ASCII | Código: Texto propiedad: Variable de texto propiedad: Producción: |
|
| Salida de cadena Tipos de datos recomendados: | Código: Texto propiedad: Variable de texto propiedad: Producción: Cuando la codificación UTF-8 está habilitada para Para más información, ver: Cuadro de diálogo: Configuración del proyecto: Opciones de compilación |
Signo de porcentaje
Especificación de formato para generar un signo de porcentaje
Sintaxis | Ejemplo | Descripción | Ejemplo en visualización |
---|---|---|---|
|
| Salida del signo de porcentaje | Con una variable de marcador de posición: Código: Texto propiedad: Variable de texto propiedad: Producción: |
Texto propiedad: Producción: |