En esta página

Locale QML Type

Proporciona propiedades específicas de la configuración regional y datos formateados. Más...

Import Statement: import QtQml

Propiedades

Métodos

Descripción detallada

El objeto Locale solo se puede crear mediante la función Qt.locale(). No se puede crear directamente.

La función Qt.locale() devuelve un objeto Locale de JavaScript que representa la configuración regional con el nombre especificado, que tiene el formato «idioma[_territorio][.conjunto de códigos][@modificador]» 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 de configuración regional predeterminado.

El objeto Locale proporciona una serie de funciones y propiedades que ofrecen datos sobre la configuración regional especificada.

El objeto Locale también puede pasarse a los métodos toLocaleString() y fromLocaleString() de Date y Number para convertir cadenas utilizando la configuración regional especificada.

Este ejemplo muestra la fecha actual formateada según 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 con el formato correcto para la configuración regional predeterminada:

import QtQuick 2.0

Text {
    text: "The value is: " + Number(23443.34).toLocaleString(Qt.locale())
}

Qt Quick Los datos de configuración regional se basan en el Common Locale Data Repository v1.8.1.

Tipos de formato de cadenas de configuración regional

Los métodos ` monthName()`, ` standaloneMonthName()`, ` dayName()` y ` standaloneDayName()` pueden utilizar los siguientes valores de enumeración para especificar el formato de la representación en cadena de un objeto `Date`.

ConstanteDescripción
Locale.LongFormatLa versión completa de los nombres de los días y los meses; por ejemplo, devuelve «enero» como nombre del mes.
Locale.ShortFormatLa versión abreviada de los nombres de los días y los meses; por ejemplo, devuelve «Jan» como nombre del mes.
Locale.NarrowFormatUna versión especial de los nombres de los días y los meses para usar cuando el espacio es limitado; por ejemplo, devuelve «J» como nombre del mes. Ten en cuenta que el formato compacto 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 compactos, por lo que debes evitar utilizarlo para el formato de fechas. Además, para la configuración regional del sistema, este formato es el mismo que el ShortFormat.

Además, las funciones de conversión de doble a cadena y de cadena a doble están sujetas a 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 fin sin coste alguno, siempre que se incluya este aviso completo en todas las copias de cualquier software que sea o incluya una copia o modificación de este software, así como en todas las copias de la documentación de apoyo 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 NINGUNA DECLARACIÓN NI GARANTÍA DE NINGÚN TIPO RESPECTO A LA COMERCIABILIDAD DE ESTE SOFTWARE O A SU IDONEIDAD PARA UN FIN CONCRETO.

Este producto incluye software desarrollado por la Universidad de California, Berkeley, y sus colaboradores.

Véanse también el objeto JavaScript «Date » y el objeto JavaScript «Number».

Documentación de propiedades

amText : string

El nombre traducido del sufijo «AM» para las horas expresadas según las convenciones del sistema de 12 horas.

decimalPoint : string

Contiene el carácter que representa el punto decimal en esta configuración regional.

exponential : string

Almacena el carácter exponencial de esta configuración regional.

firstDayOfWeek : enumeration

Devuelve el primer día de la semana según la configuración regional actual.

ConstanteDescripción
Locale.Sunday0
Locale.Monday1
Locale.Tuesday2
Locale.Wednesday3
Locale.Thursday4
Locale.Friday5
Locale.Saturday6

Nota: estos valores coincidencon la API Date de JavaScript, que difiere de la API de Qt C++, en la que « Qt::Sunday » = 7.

groupSeparator : string

Contiene el carácter separador de grupos de esta configuración regional.

measurementSystem : enumeration

Esta propiedad define qué unidades se utilizan para la medición.

ConstanteDescripción
Locale.MetricSystemEste valor indica unidades métricas, como metros, centímetros y milímetros.
Locale.ImperialUSSystemEste valor indica unidades imperiales, como pulgadas y millas, tal y como se utilizan en Estados Unidos.
Locale.ImperialUKSystemEste valor indica unidades imperiales, como pulgadas y millas, tal y como se utilizan en el Reino Unido.
Locale.ImperialSystemSe proporciona por motivos de compatibilidad. Es lo mismo que Locale.ImperialUSSystem.

name : string

Almacena el idioma y el territorio de esta configuración regional como una cadena con el formato «idioma_territorio», donde «idioma» es un código de idioma ISO 639 de dos letras en minúsculas y «territorio» es un código de territorio ISO 3166 de dos o tres letras en mayúsculas.

nativeLanguageName : string

Contiene un nombre nativo en la lengua correspondiente a la configuración regional. Por ejemplo, «Schwiizertüütsch» para la configuración regional del suizo-alemán.

Véase también nativeTerritoryName.

nativeTerritoryName : string

Contiene el nombre autóctono del territorio correspondiente a la configuración regional. Por ejemplo, «España» para la configuración regional «Español/España».

Véase también nativeLanguageName.

negativeSign : string

Contiene el carácter que representa el signo negativo en 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 string Number::toLocaleString(locale, format, precision) y string Number::fromLocaleString(locale, number).

percent : string

Contiene el carácter de porcentaje de esta configuración regional.

pmText : string

El nombre traducido del sufijo «PM» para las horas expresadas según las convenciones del formato de 12 horas.

positiveSign : string

Almacena el carácter que indica el signo positivo de esta configuración regional.

textDirection : enumeration

Contiene la dirección del texto del idioma:

ConstanteDescripción
Qt.LeftToRightEl texto suele comenzar por la izquierda.
Qt.RightToLeftEl texto suele comenzar por la derecha.

uiLanguages : Array<string>

Devuelve una lista ordenada de nombres de configuraciones regionales para fines de traducción, en orden de preferencia.

El valor devuelto representa los nombres de configuraciones regionales en las que el usuario espera ver la traducción de la interfaz de usuario.

El primer elemento de la lista es el de mayor preferencia.

weekDays : Array<int>

Contiene una serie de días que se consideran días laborables según la configuración regional actual, en la que el domingo es 0 y el sábado es 6.

Véase también firstDayOfWeek.

zeroDigit : string

Holds Devuelve el carácter que representa el dígito cero en esta configuración regional.

Documentación del método

[since 6.10] string createSeparatedList(list<string> list)

Devuelve una cadena que representa la unión de una lista de cadenas dada ( list ) 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 la moneda para el format especificado:

ConstanteDescripción
Locale.CurrencyIsoCodeun código ISO-4217 de la moneda.
Locale.CurrencySymbolun símbolo de moneda.
Locale.CurrencyDisplayNameun nombre legible para el usuario de la moneda.

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 ` que se va a devolver.

Véase también El objeto JavaScript «Date».

string dateTimeFormat(type)

Devuelve el formato de fecha y hora utilizado para la configuración regional actual. ` type ` especifica el ` FormatType ` que se va a devolver.

Véase también El objeto Date de JavaScript.

string dayName(day, type)

Devuelve el nombre localizado de « day » (donde 0 representa el domingo, 1 representa el lunes y así sucesivamente), en el formato opcional « FormatType » 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 » en una cadena localizada legible para el usuario, compuesta por un número y una unidad cuantificada.

Los argumentos ` precision ` y ` format ` son opcionales.

Para obtener más información, consulta 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 rango opcional « FormatType » especificado por « type ».

Nota: la API de C++ de ` QLocale ` espera un rango de (1-12), sin embargo, `Locale.monthName()` espera valores de 0 a 11, tal y como establece el objeto `Date` de JavaScript.

Véase también dayName() y standaloneMonthName().

string standaloneDayName(day, type)

Devuelve el nombre localizado de « day » (donde 0 representa el domingo, 1 representa el lunes, y así sucesivamente) que se utiliza como texto independiente, en la configuración regional « FormatType » especificada por « type ».

Si la información de configuración regional no especifica el nombre del día por sí solo, el valor devuelto es el mismo que en ` dayName()` .

Véanse 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 configuración regional no especifica el nombre del mes independiente, el valor devuelto es el mismo que en ` monthName()` ().

Nota: la API de C++ de QLocale espera un rango de (1-12), sin embargo, Locale.standaloneMonthName() espera valores de 0 a 11, tal y como establece el objeto Date de JavaScript.

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 ` que se va a devolver.

Véase también El objeto JavaScript Date.

[since 6.5] string toString(int i)

Devuelve una representación como 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 en forma de cadena localizada del « date » dado en el « format » especificado. Si se omite « format », se utiliza « Locale.LongFormat ».

Esta es 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 como cadena localizada del « date » dado en el « format » especificado. Si « format » es una cadena vacía, se devuelve una cadena vacía.

Esta es una función sobrecargada.

Este método se introdujo en Qt 6.5.

Véase 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 coma flotante f.

El formato de la representación viene determinado por los parámetros opcionales format y precision.

Consulte QLocale::toString(double, char, int) para obtener más información.

Esta es 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.