Locale QML Type
Proporciona propiedades específicas de la configuración regional y datos formateados. Más...
| Import Statement: | import QtQml |
Propiedades
- amText : string
- decimalPoint : string
- exponential : string
- firstDayOfWeek : enumeration
- groupSeparator : string
- measurementSystem : enumeration
- name : string
- nativeLanguageName : string
- nativeTerritoryName : string
- negativeSign : string
- numberOptions : enumeration
- percent : string
- pmText : string
- positiveSign : string
- textDirection : enumeration
- uiLanguages : Array<string>
- weekDays : Array<int>
- zeroDigit : string
Métodos
- string createSeparatedList(list<string> list)
(since 6.10) - string currencySymbol(format)
- string dateFormat(type)
- string dateTimeFormat(type)
- string dayName(day, type)
- string formattedDataSize(int bytes, int precision, DataSizeFormat format)
(since 6.2) - string monthName(month, type)
- string standaloneDayName(day, type)
- string standaloneMonthName(month, type)
- string timeFormat(type)
- string toString(int i)
(since 6.5) - string toString(Date date, FormatType format)
(since 6.5) - string toString(Date date, string format)
(since 6.5) - string toString(double f, char format, int precision)
(since 6.5)
Descripción detallada
El objeto Locale sólo puede crearse a través de la función Qt.locale(). No puede crearse directamente.
La función Qt.locale() devuelve un objeto JS Locale que representa la configuración regional con el nombre especificado, que tiene el formato "language[_territory][.codeset][@modifier]" o "C".
Locale admite el concepto de configuración regional predeterminada, que se determina a partir de la configuración regional del sistema al iniciar la aplicación. Si no se pasa ningún parámetro a Qt.locale() se devuelve el objeto locale por defecto.
El objeto Locale proporciona una serie de funciones y propiedades que proporcionan datos para la configuración regional especificada.
El objeto Locale también puede pasarse a los métodos Date y Number toLocaleString() y fromLocaleString() para convertir a/de cadenas utilizando la configuración regional especificada.
Este ejemplo muestra la fecha actual formateada para la configuración regional alemana:
import QtQuick 2.0 Text { text: "The date is: " + Date().toLocaleString(Qt.locale("de_DE")) }
El siguiente ejemplo muestra el número especificado en el formato correcto para la configuración regional por defecto:
import QtQuick 2.0 Text { text: "The value is: " + Number(23443.34).toLocaleString(Qt.locale()) }
Qt Quick Los datos de la configuración regional se basan en Common Locale Data Repository v1.8.1.
Tipos de formato de cadena de locale
Las funciones monthName(), standaloneMonthName(), dayName() y standaloneDayName() pueden utilizar los siguientes valores de enumeración para especificar el formato de la representación de cadena para un objeto Date.
| Constante | Descripción |
|---|---|
Locale.LongFormat | La versión larga de los nombres de día y mes; por ejemplo, devuelve "Enero" como nombre de mes. |
Locale.ShortFormat | La versión abreviada de los nombres de día y mes; por ejemplo, devuelve "Enero" como nombre de mes. |
Locale.NarrowFormat | Una versión especial de los nombres de día y mes para utilizar cuando el espacio es limitado; por ejemplo, devolver "J" como nombre de mes. Tenga en cuenta que el formato estrecho puede contener el mismo texto para diferentes meses y días o incluso puede ser una cadena vacía si la configuración regional no admite nombres estrechos, por lo que debe evitar utilizarlo para el formato de fecha. Además, para la configuración regional del sistema, este formato es el mismo que ShortFormat. |
Además, las funciones de conversión de doble a cadena y de cadena a doble están cubiertas por las siguientes licencias:
Copyright (c) 1991 por AT&T.
Por la presente se concede permiso para utilizar, copiar, modificar y distribuir este software para cualquier propósito sin coste alguno, siempre que este aviso completo se incluya en todas las copias de cualquier software que sea o incluya una copia o modificación de este software y en todas las copias de la documentación de soporte de dicho software.
ESTE SOFTWARE SE PROPORCIONA "TAL CUAL", SIN NINGUNA GARANTÍA EXPRESA O IMPLÍCITA. EN PARTICULAR, NI EL AUTOR NI AT&T OFRECEN NINGÚN TIPO DE REPRESENTACIÓN O GARANTÍA EN RELACIÓN CON LA COMERCIABILIDAD DE ESTE SOFTWARE O SU IDONEIDAD PARA UN FIN DETERMINADO.
Este producto incluye software desarrollado por la Universidad de California, Berkeley y sus colaboradores.
Véase también El objeto JavaScript de fecha y El objeto JavaScript de número.
Documentación de propiedades
amText : string
El nombre localizado del sufijo "AM" para las horas especificadas utilizando las convenciones del reloj de 12 horas.
decimalPoint : string
Contiene el carácter de punto decimal de esta configuración regional.
exponential : string
Contiene el carácter exponencial de esta configuración regional.
firstDayOfWeek : enumeration
Indica el primer día de la semana según la configuración regional actual.
| Constante | Descripción |
|---|---|
Locale.Sunday | 0 |
Locale.Monday | 1 |
Locale.Tuesday | 2 |
Locale.Wednesday | 3 |
Locale.Thursday | 4 |
Locale.Friday | 5 |
Locale.Saturday | 6 |
Nota: que estos valores coinciden con la API JS Date que es diferente de la API Qt C++ donde Qt::Sunday = 7.
groupSeparator : string
Contiene el carácter separador de grupo de esta configuración regional.
measurementSystem : enumeration
Esta propiedad define qué unidades se utilizan para la medición.
| Constante | Descripción |
|---|---|
Locale.MetricSystem | Este valor indica unidades métricas, como metros, centímetros y milímetros. |
Locale.ImperialUSSystem | Este valor indica unidades imperiales, como pulgadas y millas, tal y como se utilizan en Estados Unidos. |
Locale.ImperialUKSystem | Este valor indica unidades imperiales, como pulgadas y millas, tal y como se utilizan en el Reino Unido. |
Locale.ImperialSystem | Se proporciona por compatibilidad. Igual que Locale.ImperialUSSystem. |
name : string
Contiene el idioma y el territorio de esta configuración regional como una cadena de texto de la forma "idioma_territorio", donde idioma es un código de idioma ISO 639 de dos letras en minúscula y territorio es un código de territorio ISO 3166 de dos o tres letras en mayúscula.
nativeLanguageName : string
Contiene un nombre nativo del idioma para la configuración regional. Por ejemplo, "Schwiizertüütsch" para la configuración regional suizo-alemana.
Véase también nativeTerritoryName.
nativeTerritoryName : string
Contiene un nombre nativo del territorio para la configuración regional. Por ejemplo, "España" para la configuración regional española.
Véase también nativeLanguageName.
negativeSign : string
Contiene el carácter de signo negativo de esta configuración regional.
numberOptions : enumeration
Contiene un conjunto de opciones para las conversiones de número a cadena y de cadena a número.
Véase también cadena Número::toLocaleString(configuración regional, formato, precisión) y cadena Número::fromLocaleString(configuración regional, número).
percent : string
Contiene el carácter de porcentaje de esta configuración regional.
pmText : string
El nombre localizado del sufijo "PM" para las horas especificadas utilizando las convenciones del reloj de 12 horas.
positiveSign : string
Contiene el carácter de signo positivo de esta configuración regional.
textDirection : enumeration
Mantiene la dirección del texto de la lengua:
| Constante | Descripción |
|---|---|
Qt.LeftToRight | El texto empieza normalmente por la izquierda. |
Qt.RightToLeft | El texto empieza normalmente por la derecha. |
uiLanguages : Array<string>
Devuelve una lista ordenada de nombres de configuración regional con fines de traducción en orden de preferencia.
El valor devuelto representa los nombres de configuración regional en los que el usuario espera ver la traducción de la interfaz de usuario.
El primer elemento de la lista es el más preferido.
weekDays : Array<int>
Contiene una matriz de días que se consideran días de la semana según la configuración regional actual, donde domingo es 0 y sábado es 6.
Véase también firstDayOfWeek.
zeroDigit : string
Holds Devuelve el carácter de dígito cero de esta configuración regional.
Documentación del método
[since 6.10] string createSeparatedList(list<string> list)
Devuelve una cadena que representa una unión de un list dado de cadenas con un separador definido por la configuración regional.
Este método se introdujo en Qt 6.10.
Véase también QLocale::createSeparatedList().
string currencySymbol(format)
Devuelve el símbolo de moneda para el format especificado:
| Constante | Descripción |
|---|---|
Locale.CurrencyIsoCode | un código ISO-4217 de la moneda. |
Locale.CurrencySymbol | un símbolo de moneda. |
Locale.CurrencyDisplayName | un nombre de la moneda legible por el usuario. |
Véase también la cadena Number::toLocaleCurrencyString(locale, symbol).
string dateFormat(type)
Devuelve el formato de fecha utilizado para la configuración regional actual. type especifica el FormatType a devolver.
Véase también El objeto Date de JavaScript.
string dateTimeFormat(type)
Devuelve el formato de fecha y hora utilizado para la configuración regional actual. type especifica el FormatType a devolver.
Véase también El objeto Date de JavaScript.
string dayName(day, type)
Devuelve el nombre localizado del day (donde 0 representa domingo, 1 representa lunes y así sucesivamente), en el FormatType opcional especificado por type.
Véase también monthName() y standaloneDayName().
[since 6.2] string formattedDataSize(int bytes, int precision, DataSizeFormat format)
Convierte un tamaño en bytes a una cadena localizada legible por humanos, que comprende un número y una unidad cuantificada.
Los argumentos precision y format son opcionales.
Para obtener más información, consulte QLocale::formattedDataSize().
Este método se introdujo en Qt 6.2.
Véase también QLocale::DataSizeFormats.
string monthName(month, type)
Devuelve el nombre localizado de month (0-11), en el FormatType opcional especificado por type.
Nota: la API C++ QLocale espera un rango de (1-12), sin embargo Locale.monthName() espera 0-11 según el objeto JS Date.
Véase también dayName() y standaloneMonthName().
string standaloneDayName(day, type)
Devuelve el nombre localizado del day (donde 0 representa domingo, 1 representa lunes y así sucesivamente) que se utiliza como texto independiente, en el FormatType especificado por type.
Si la información de configuración regional no especifica el nombre del día independiente, el valor devuelto es el mismo que en dayName().
Véase también dayName() y standaloneMonthName().
string standaloneMonthName(month, type)
Devuelve el nombre localizado de month (0-11) que se utiliza como texto independiente, en el FormatType opcional especificado por type.
Si la información de localización no especifica el nombre del mes independiente, el valor devuelto es el mismo que en monthName().
Nota: la API de C++ QLocale espera un rango de (1-12), sin embargo Locale.standaloneMonthName() espera 0-11 según el objeto JS Date.
Véase también monthName() y standaloneDayName().
string timeFormat(type)
Devuelve el formato de hora utilizado para la configuración regional actual. type especifica el FormatType a devolver.
Véase también El objeto Date de JavaScript.
[since 6.5] string toString(int i)
Devuelve una representación de cadena localizada de i.
Este método se introdujo en Qt 6.5.
Véase también QLocale::toString(int).
[since 6.5] string toString(Date date, FormatType format = LongFormat)
Devuelve una representación de cadena localizada del date dado en el format especificado. Si se omite format, se utiliza Locale.LongFormat.
Se trata de una función sobrecargada.
Este método se introdujo en Qt 6.5.
Véase también QLocale::toString(QDate, QLocale::FormatType).
[since 6.5] string toString(Date date, string format)
Devuelve una representación de cadena localizada del date dado en el format especificado. Si format es una cadena vacía, se devuelve una cadena vacía.
Se trata de una función sobrecargada.
Este método se introdujo en Qt 6.5.
Ver también QLocale::toString(QDate, QStringView).
[since 6.5] string toString(double f, char format = 'g', int precision = 6)
Devuelve una cadena que representa el número de punto flotante f.
La forma de la representación se controla mediante los parámetros opcionales format y precision.
Véase QLocale::toString(double, char, int) para más información.
Se trata de una función sobrecargada.
Este método se introdujo en Qt 6.5.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
