QLocale Class

Documentación de las funciones de los miembros

QLocale::QLocale()

Construye un objeto QLocale inicializado con la configuración regional por defecto.

Si no se estableció ninguna configuración regional por defecto usando setDefault(), esta configuración regional será la misma que la devuelta por system().

Véase también setDefault() y system().

[explicit, since 6.3] QLocale::QLocale(QStringView name)

Construye un objeto QLocale con el nombre name especificado.

El nombre tiene el formato "language[_script][_territory][.codeset][@modifier]" o "C", donde:

• language es un código de idioma ISO 639 de dos letras en minúscula (también se reconocen algunos códigos de tres letras),
• escritura es un código de escritura ISO 15924 de cuatro letras en mayúscula,
• territorio es un código de territorio ISO 3166 de dos letras en mayúscula (también se reconocen algunos códigos numéricos), y
• se ignoran el conjunto de códigos y el modificador.

El separador puede ser un guión bajo '_' (U+005F, "línea baja") o un guión '-' (U+002D, "guión-menos"). Si QLocale no dispone de datos para la combinación de idioma, escritura y territorio especificada, utilizará en su lugar la coincidencia más adecuada que pueda encontrar. Si la cadena viola el formato de la configuración regional, o no se pueden encontrar datos adecuados para las claves especificadas, se utiliza la configuración regional "C" en su lugar.

Este constructor es mucho más lento que QLocale(Language, Script, Territory) o QLocale(Language, Territory).

Esta función se introdujo en Qt 6.3.

Véase también bcp47Name() y Matching combinations of language, script and territory.

QLocale::QLocale(QLocale::Language language, QLocale::Territory territory)

Construye un objeto QLocale para las language y territory especificadas.

Si hay más de un script en uso para esta combinación, se seleccionará un script probable. Si QLocale no tiene datos para el language especificado, se utilizará la configuración regional por defecto. Si QLocale no tiene datos para la combinación especificada de language y territory, se utilizará un territorio alternativo en su lugar.

Véase también setDefault() y Matching combinations of language, script and territory.

QLocale::QLocale(QLocale::Language language, QLocale::Script script = AnyScript, QLocale::Territory territory = AnyTerritory)

Construye un objeto QLocale para las combinaciones language, script y territory especificadas.

Si QLocale no tiene datos para la combinación indicada, buscará datos que coincidan lo mejor posible. Si

• language es AnyLanguage y no se puede deducir ningún idioma de script y territory
• QLocale no tiene datos para el idioma, ya sea dado como language o inferido como arriba.

Véase también setDefault() y Matching combinations of language, script and territory.

[explicit] QLocale::QLocale(const QString &name)

[noexcept] QLocale::QLocale(const QLocale &other)

Construye un objeto QLocale como copia de other.

[noexcept] QLocale::~QLocale()

Destructor

QString QLocale::amText() const

Devuelve el nombre localizado del sufijo "AM" para las horas especificadas utilizando las convenciones del reloj de 12 horas.

Véase también pmText().

QString QLocale::bcp47Name(QLocale::TagSeparator separator = TagSeparator::Dash) const

Devuelve los nombres de campo BCP47 unidos por guiones.

Esto combina tantos campos de idioma, escritura y territorio (y posiblemente otros campos BCP47) para esta configuración regional como sean necesarios para especificarla de forma única. Tenga en cuenta que los campos pueden omitirse si el consorcio Unicode Likely Subtag Rules implica los campos omitidos cuando se dan esos retenidos. Véase name() para saber cómo construir una cadena a partir de campos individuales, si se necesita algún otro formato.

A diferencia de uiLanguages(), el valor devuelto por bcp47Name() representa el nombre de la configuración regional de los datos de QLocale; no tiene por qué ser el idioma en el que debe estar la interfaz de usuario.

Esta función intenta ajustar el nombre de la configuración regional a la Mejor Práctica Común 47 del IETF, definida por RFC 5646. Desde Qt 6.7, admite un parámetro opcional separator que puede utilizarse para anular el uso especificado por BCP47 de un guión para separar las etiquetas. Sin embargo, para su uso en protocolos definidos por el IETF, debe mantenerse el valor por defecto, QLocale::TagSeparator::Dash.

Véase también name(), language(), territory(), script() y uiLanguages().

[static noexcept] QLocale QLocale::c()

Devuelve un objeto QLocale inicializado con la configuración regional "C".

Esta configuración regional se basa en en_US pero con varias peculiaridades propias, como el formato simplificado de los números y su propio formato de fecha. Implementa los estándares POSIX que describen el comportamiento de las funciones de la biblioteca estándar del lenguaje de programación "C".

Entre otras cosas, esto significa que su orden de cotejo se basa en los valores ASCII de las letras, de modo que (para la ordenación sensible a mayúsculas y minúsculas) todas las letras mayúsculas se ordenan antes que cualquier letra minúscula (en lugar de que las formas mayúscula y minúscula de cada letra se ordenen adyacentes entre sí, antes que las dos formas de la letra siguiente).

Véase también system().

[static noexcept, since 6.3] QLocale::Language QLocale::codeToLanguage(QStringView languageCode, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)

Devuelve el enum QLocale::Language correspondiente al código de dos o tres letras languageCode, tal y como se define en las normas ISO 639.

Si se especifica, codeTypes selecciona qué conjunto de códigos considerar para la conversión. Por defecto se consideran todos los códigos conocidos por Qt. Los códigos se emparejan en el siguiente orden: ISO639Part1, ISO639Part2B, ISO639Part2T, ISO639Part3, LegacyLanguageCode.

Si el código no es válido o no se conoce, se devuelve QLocale::AnyLanguage.

Esta función se introdujo en Qt 6.3.

Véase también languageToCode(), codeToTerritory(), y codeToScript().

[static noexcept, since 6.1] QLocale::Script QLocale::codeToScript(QStringView scriptCode)

Devuelve el enum QLocale::Script correspondiente a la escritura de cuatro letras scriptCode, tal como se define en la norma ISO 15924.

Si el código no es válido o no se conoce se devuelve QLocale::AnyScript.

Esta función se introdujo en Qt 6.1.

Véase también scriptToCode(), codeToLanguage(), y codeToTerritory().

[static noexcept, since 6.2] QLocale::Territory QLocale::codeToTerritory(QStringView territoryCode)

Devuelve el enum QLocale::Territory correspondiente al código de dos letras o tres dígitos territoryCode, tal como se define en la norma ISO 3166.

Si el código no es válido o no se conoce se devuelve QLocale::AnyTerritory.

Esta función se introdujo en Qt 6.2.

Véase también territoryToCode(), codeToLanguage(), y codeToScript().

QLocale QLocale::collation() const

Devuelve la configuración regional a utilizar para la intercalación.

El resultado suele ser esta configuración regional; sin embargo, la configuración regional del sistema (que suele ser la predeterminada) devolverá la configuración regional de cotejo del sistema. El resultado es adecuado para pasarlo al constructor de QCollator.

Véase también QCollator.

QString QLocale::createSeparatedList(const QStringList &list) const

Devuelve una cadena que representa una unión de un list dado de cadenas con un separador definido por la configuración regional.

QString QLocale::currencySymbol(QLocale::CurrencySymbolFormat format = CurrencySymbol) const

Devuelve un símbolo de moneda según la dirección format.

QString QLocale::dateFormat(QLocale::FormatType format = LongFormat) const

Devuelve el formato de fecha utilizado para la configuración regional actual.

Si format es LongFormat, el formato será elaborado, de lo contrario será abreviado. Por ejemplo, LongFormat para la configuración regional en_US es dddd, MMMM d, yyyy, ShortFormat es M/d/yy.

Véase también QDate::toString() y QDate::fromString().

QString QLocale::dateTimeFormat(QLocale::FormatType format = LongFormat) const

Devuelve el formato fecha-hora utilizado para la configuración regional actual.

Si format es LongFormat, el formato será elaborado, de lo contrario será abreviado. Por ejemplo, LongFormat para la configuración regional en_US es dddd, MMMM d, yyyy h:mm:ss AP t, ShortFormat es M/d/yy h:mm AP.

Véase también QDateTime::toString() y QDateTime::fromString().

QString QLocale::dayName(int day, QLocale::FormatType type = LongFormat) const

Devuelve el nombre localizado de day (donde 1 representa lunes, 2 representa martes y así sucesivamente), en el formato especificado por type.

Por ejemplo, si la configuración regional es en_US y day es 1, LongFormat devolverá Monday, ShortFormat Mon , y NarrowFormat M .

Véase también monthName() y standaloneDayName().

QString QLocale::decimalPoint() const

Devuelve el separador de partes fraccionarias para esta configuración regional.

Este es el token que separa la parte entera del número de la parte fraccional en la representación de un número que tiene una parte fraccionaria. Esto se llama comúnmente el "carácter de punto decimal" - a pesar de que, en muchos locales, no es un "punto" (o punto similar). Se devuelve (desde Qt 6.0) como una cadena en caso de que alguna localización necesite más de un punto de código UTF-16 para representar su separador.

Véase también groupSeparator() y toString().

QString QLocale::exponential() const

Devuelve el separador de exponente para esta configuración regional.

Se trata de un símbolo utilizado para separar la mantisa del exponente en algunas representaciones numéricas de coma flotante. Se devuelve (desde Qt 6.0) como una cadena porque, en algunas localizaciones, no es un único carácter - por ejemplo, puede consistir en un signo de multiplicación y una representación del operador "diez a la potencia".

Véase también toString(double, char, int).

Qt::DayOfWeek QLocale::firstDayOfWeek() const

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

QString QLocale::formattedDataSize(qint64 bytes, int precision = 2, QLocale::DataSizeFormats format = DataSizeIecFormat) const

Convierte un tamaño en bytes en una cadena localizada legible por humanos, que comprende un número y una unidad cuantificada. El cuantificador se elige de forma que el número sea al menos uno y lo más pequeño posible. Por ejemplo, si bytes es 16384, precision es 2 y format es DataSizeIecFormat (el valor predeterminado), esta función devuelve "16,00 KiB"; para 1330409069609 bytes devuelve "1,21 GiB"; y así sucesivamente. Si format es DataSizeIecFormat o DataSizeTraditionalFormat, el número de bytes dado se divide por una potencia de 1024, con resultado inferior a 1024; para DataSizeSIFormat, se divide por una potencia de 1000, con resultado inferior a 1000. DataSizeIecFormat utiliza los nuevos cuantificadores estándar IEC Ki, Mi, etc., mientras que DataSizeSIFormat utiliza los antiguos cuantificadores SI k, M, etc., y DataSizeTraditionalFormat abusa de ellos.

QString QLocale::groupSeparator() const

Devuelve el separador de agrupación de dígitos para esta configuración regional.

Se trata de un token que se utiliza para dividir secuencias largas de dígitos en la representación de un número para facilitar su lectura. En algunas localizaciones puede estar vacío, indicando que los dígitos no deben dividirse en grupos de esta forma. En otras puede ser un carácter de espaciado. Se devuelve (desde Qt 6.0) como una cadena en caso de que alguna localización necesite más de un punto de código UTF-16 para representar su separador.

Véase también decimalPoint() y toString().

QLocale::Language QLocale::language() const

Devuelve el idioma de esta localización.

Véase también script(), territory(), languageToString() y bcp47Name().

[static, since 6.3] QString QLocale::languageToCode(QLocale::Language language, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)

Devuelve el código de idioma de dos o tres letras para language, tal y como se define en las normas ISO 639.

Si se especifica, codeTypes selecciona el conjunto de códigos a considerar. Se devuelve el primer código del conjunto definido para language. En caso contrario, se tienen en cuenta todos los códigos ISO-639. Los códigos se consideran en el orden siguiente ISO639Part1, ISO639Part2B, ISO639Part2T, ISO639Part3. Esta función ignora LegacyLanguageCode.

Esta función se introdujo en Qt 6.3.

Véase también codeToLanguage(), language(), name(), bcp47Name(), territoryToCode(), y scriptToCode().

[static] QString QLocale::languageToString(QLocale::Language language)

Devuelve un QString que contiene el nombre de language.

Véase también territoryToString(), scriptToString() y bcp47Name().

[static] QList<QLocale> QLocale::matchingLocales(QLocale::Language language, QLocale::Script script, QLocale::Territory territory)

Devuelve una lista de objetos locale válidos que coinciden con los dados language, script y territory.

Obtención de una lista de todas las configuraciones regionales: QList<QLocale> allLocales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::AnyTerritory);

Obtener una lista de locales adecuados para Rusia: QList<QLocale> locales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::Russia);

QLocale::MeasurementSystem QLocale::measurementSystem() const

Devuelve el sistema de medida de la configuración regional.

QString QLocale::monthName(int month, QLocale::FormatType type = LongFormat) const

Devuelve el nombre localizado de month, en el formato especificado por type.

Por ejemplo, si la configuración regional es en_US y month es 1, LongFormat devolverá January. ShortFormat Jan y NarrowFormat J .

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

QString QLocale::name(QLocale::TagSeparator separator = TagSeparator::Underscore) const

El nombre corto de esta localización.

Devuelve el idioma y el territorio de esta localización como una cadena 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. Si la configuración regional no tiene un territorio especificado, sólo se devuelve el nombre del idioma. Desde Qt 6.7 se puede suministrar un parámetro opcional separator para anular el carácter de subrayado predeterminado que separa las dos etiquetas.

Incluso si el objeto QLocale se construyó con un guión explícito, name() no lo contendrá por razones de compatibilidad. Utilice bcp47Name() en su lugar si necesita un nombre de localización completo, o construya la cadena con la que desea identificar una localización a partir de las devueltas pasando su language() a languageToCode() y similares para el script y el territorio.

Véase también QLocale(), language(), script(), territory(), bcp47Name() y uiLanguages().

QString QLocale::nativeLanguageName() const

Devuelve un nombre nativo del idioma para la configuración regional. Por ejemplo, "Schweizer Hochdeutsch" para la configuración regional suizo-alemana.

Véase también nativeTerritoryName() y languageToString().

[since 6.2] QString QLocale::nativeTerritoryName() const

Devuelve un nombre nativo del territorio para la configuración regional. Por ejemplo "España" para la configuración regional Español/España.

Esta función se introdujo en Qt 6.2.

Véase también nativeLanguageName() y territoryToString().

QString QLocale::negativeSign() const

Devuelve el indicador de signo negativo de esta localización.

Se trata de un token que se supone que se utiliza como prefijo de un número para indicar que es negativo. Se devuelve (desde Qt 6.0) como una cadena porque, en algunas localizaciones, no es un único carácter - por ejemplo, porque incluye un carácter de control de dirección de texto.

Véase también positiveSign() y toString().

QLocale::NumberOptions QLocale::numberOptions() const

Devuelve las opciones relacionadas con las conversiones numéricas para esta instancia de QLocale.

Por defecto, no se establecen opciones para las configuraciones regionales estándar, excepto para la configuración regional "C", que tiene OmitGroupSeparator establecido por defecto.

Véase también setNumberOptions(), toString(), groupSeparator(), y FloatingPointPrecisionOption.

QString QLocale::percent() const

Devuelve el marcador de porcentaje de esta localización.

Se trata de un token que se supone que se añade a un número para indicar un porcentaje. Se devuelve (desde Qt 6.0) como una cadena porque, en algunas localizaciones, no es un único carácter - por ejemplo, porque incluye un carácter de control de dirección de texto.

Véase también toString().

QString QLocale::pmText() const

Devuelve el nombre localizado del sufijo "PM" para las horas especificadas utilizando las convenciones del reloj de 12 horas.

Véase también amText().

QString QLocale::positiveSign() const

Devuelve el indicador de signo positivo de esta localización.

Se trata de un token que se supone que se utiliza como prefijo de un número para indicar que es positivo. Se devuelve (desde Qt 6.0) como una cadena porque, en algunas localizaciones, no es un único carácter - por ejemplo, porque incluye un carácter de control de dirección de texto.

Véase también negativeSign() y toString().

QString QLocale::quoteString(const QString &str, QLocale::QuotationStyle style = StandardQuotation) const

Devuelve str entrecomillado según la configuración regional actual utilizando la cita dada style.

[since 6.0] QString QLocale::quoteString(QStringView str, QLocale::QuotationStyle style = StandardQuotation) const

Esta función se introdujo en Qt 6.0.

QLocale::Script QLocale::script() const

Devuelve el script de esta localización.

Véase también language(), territory(), languageToString(), scriptToString() y bcp47Name().

[static, since 6.1] QString QLocale::scriptToCode(QLocale::Script script)

Devuelve el código de escritura de cuatro letras para script, tal como se define en la norma ISO 15924.

Esta función se introdujo en Qt 6.1.

Véase también script(), name(), bcp47Name(), languageToCode(), y territoryToCode().

[static] QString QLocale::scriptToString(QLocale::Script script)

Devuelve un QString que contiene el nombre de script.

Véase también languageToString(), territoryToString(), script() y bcp47Name().

[static] void QLocale::setDefault(const QLocale &locale)

Establece la configuración regional global por defecto en locale.

Esta configuración regional se utiliza cuando se construye un objeto QLocale sin argumentos. Si no se llama a esta función, se utiliza la configuración regional del sistema.

Advertencia: Esta función no es reentrante.

Véase también system() y c().

void QLocale::setNumberOptions(QLocale::NumberOptions options)

Establece el options relacionado con las conversiones numéricas para esta instancia QLocale.

Véase también numberOptions() y FloatingPointPrecisionOption.

QString QLocale::standaloneDayName(int day, QLocale::FormatType type = LongFormat) const

Devuelve el nombre localizado de day (donde 1 representa lunes, 2 representa martes y así sucesivamente) que se utiliza como texto independiente, en el formato 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().

QString QLocale::standaloneMonthName(int month, QLocale::FormatType type = LongFormat) const

Devuelve el nombre localizado de month que se utiliza como texto independiente, en el formato 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().

Véase también monthName() y standaloneDayName().

[noexcept] void QLocale::swap(QLocale &other)

Cambia esta configuración regional por other. Esta operación es muy rápida y nunca falla.

[static] QLocale QLocale::system()

Devuelve un objeto QLocale inicializado con la configuración regional del sistema.

La configuración regional del sistema puede utilizar fuentes específicas del sistema para los datos de configuración regional, si están disponibles, o bien recurrir a la entrada de la base de datos incorporada de QLocale para el idioma, la escritura y el territorio de los que informa el sistema.

Por ejemplo, en Windows y Mac, esta configuración regional utilizará los caracteres decimales/de agrupación y los formatos de fecha/hora especificados en el panel de configuración del sistema.

Véase también c().

[since 6.2] QLocale::Territory QLocale::territory() const

Devuelve el territorio de esta configuración regional.

Esta función se introdujo en Qt 6.2.

Véase también language(), script(), territoryToString(), y bcp47Name().

[static, since 6.2] QString QLocale::territoryToCode(QLocale::Territory territory)

Devuelve el código de territorio de dos letras para territory, tal y como se define en la norma ISO 3166.

Esta función se introdujo en Qt 6.2.

Véase también codeToTerritory(), territory(), name(), bcp47Name(), languageToCode(), y scriptToCode().

[static, since 6.2] QString QLocale::territoryToString(QLocale::Territory territory)

Devuelve un QString que contiene el nombre de territory.

Esta función se introdujo en Qt 6.2.

Véase también languageToString(), scriptToString(), territory(), y bcp47Name().

Qt::LayoutDirection QLocale::textDirection() const

Devuelve la dirección del texto del idioma.

QString QLocale::timeFormat(QLocale::FormatType format = LongFormat) const

Devuelve el formato de hora utilizado para la configuración regional actual.

Si format es LongFormat, el formato será elaborado, de lo contrario será corto. Por ejemplo, LongFormat para la configuración regional en_US es h:mm:ss AP t, ShortFormat es h:mm AP.

Véase también QTime::toString() y QTime::fromString().

QString QLocale::toCurrencyString(qlonglong value, const QString &symbol = QString()) const

Devuelve una representación de cadena localizada de value como moneda. Si se proporciona symbol, se utilizará en lugar del símbolo de moneda predeterminado.

Véase también currencySymbol().

QString QLocale::toCurrencyString(int value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(qulonglong value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(short value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(uint value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(ushort value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(double value, const QString &symbol = QString(), int precision = -1) const

Devuelve una representación de cadena localizada de value como moneda. Si se proporciona symbol, se utiliza en lugar del símbolo de moneda predeterminado. Si se proporciona precision, se utiliza para establecer la precisión del valor de la moneda.

Véase también currencySymbol().

QString QLocale::toCurrencyString(float i, const QString &symbol = QString(), int precision = -1) const

QDate QLocale::toDate(const QString &string, QLocale::FormatType format = LongFormat, int baseYear = DefaultTwoDigitBaseYear) const

Lee string como una fecha en una localización específica format.

Analiza string y devuelve la fecha que representa. El formato de la cadena de fecha se elige según el parámetro format (véase dateFormat()).

Algunas localizaciones utilizan, en particular para ShortFormat, sólo los dos últimos dígitos del año. En tal caso, los 100 años a partir de baseYear son los candidatos considerados en primer lugar. Antes de la versión 6.7 no existía el parámetro baseYear y siempre se utilizaba 1900. Este es el valor por defecto para baseYear, seleccionando un año desde entonces hasta 1999. En algunos casos, otros campos pueden hacer que se seleccione el siglo siguiente o el anterior, para obtener un resultado coherente con todos los campos dados. Véase QDate::fromString() para más detalles.

Si no se puede analizar la fecha, devuelve una fecha no válida.

Véase también dateFormat(), toTime(), toDateTime() y QDate::fromString().

QDate QLocale::toDate(const QString &string, const QString &format, int baseYear = DefaultTwoDigitBaseYear) const

Lee string como una fecha en el format dado.

Analiza string y devuelve la fecha que representa. Véase QDate::fromString() para la interpretación de format.

Cuando format sólo especifica los dos últimos dígitos de un año, los 100 años que comienzan en baseYear son los candidatos considerados en primer lugar. Antes de la versión 6.7 no existía el parámetro baseYear y siempre se utilizaba 1900. Este es el valor por defecto para baseYear, seleccionando un año desde entonces hasta 1999. En algunos casos, otros campos pueden hacer que se seleccione el siglo siguiente o el anterior, para obtener un resultado coherente con todos los campos dados. Véase QDate::fromString() para más detalles.

Si no se puede analizar la fecha, devuelve una fecha no válida.

Véase también dateFormat(), toTime(), toDateTime() y QDate::fromString().

QDate QLocale::toDate(const QString &string, QLocale::FormatType format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDate QLocale::toDate(const QString &string, const QString &format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format = LongFormat, int baseYear = DefaultTwoDigitBaseYear) const

Lee string como una fecha-hora en un formato específico de la localidad format.

Analiza string y devuelve la fecha-hora que representa. El formato de la cadena de fecha se elige según el parámetro format (véase dateFormat()).

Algunas localizaciones utilizan, en particular para ShortFormat, sólo los dos últimos dígitos del año. En tal caso, los 100 años a partir de baseYear son los candidatos considerados en primer lugar. Antes de la versión 6.7 no existía el parámetro baseYear y siempre se utilizaba 1900. Este es el valor por defecto para baseYear, seleccionando un año desde entonces hasta 1999. En algunos casos, otros campos pueden hacer que se seleccione el siglo siguiente o el anterior, para obtener un resultado coherente con todos los campos dados. Véase QDate::fromString() para más detalles.

Si no se puede analizar la cadena, devuelve un QDateTime no válido.

Véase también dateTimeFormat(), toTime(), toDate() y QDateTime::fromString().

QDateTime QLocale::toDateTime(const QString &string, const QString &format, int baseYear = DefaultTwoDigitBaseYear) const

Lee string como una fecha-hora en la dirección format.

Analiza string y devuelve la fecha-hora que representa. Véase QDateTime::fromString() para la interpretación de format.

Cuando format sólo especifica los dos últimos dígitos de un año, los 100 años que comienzan en baseYear son los candidatos considerados en primer lugar. Antes de la versión 6.7 no existía el parámetro baseYear y siempre se utilizaba 1900. Este es el valor por defecto para baseYear, seleccionando un año desde entonces hasta 1999. En algunos casos, otros campos pueden hacer que se seleccione el siglo siguiente o el anterior, para obtener un resultado coherente con todos los campos dados. Véase QDate::fromString() para más detalles.

Si no se puede analizar la cadena, se devuelve un QDateTime no válido. Si se puede analizar la cadena y representa una fecha-hora no válida (por ejemplo, en un hueco saltado por una transición de zona horaria), se devuelve un QDateTime no válido, cuyo toMSecsSinceEpoch() representa una fecha-hora cercana que sí es válida. Si se pasa a fromMSecsSinceEpoch() se obtendrá una fecha-hora válida que no está fielmente representada por la cadena analizada.

Véase también dateTimeFormat(), toTime(), toDate() y QDateTime::fromString().

QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDateTime QLocale::toDateTime(const QString &string, const QString &format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

double QLocale::toDouble(QStringView s, bool *ok = nullptr) const

Devuelve el doble representado por la cadena localizada s.

Devuelve un infinito si la conversión se desborda o 0,0 si la conversión falla por cualquier otro motivo (por ejemplo, desbordamiento por defecto).

Si ok no es nullptr, se informa del fallo estableciendo *ok en false, y del éxito estableciendo *ok en true.

bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble(u"1234.56", &ok);  // ok == true,  d == 1234.56
d = c.toDouble(u"1,234.56", &ok); // ok == true,  d == 1234.56
d = c.toDouble(u"1234,56", &ok);  // ok == false, d == 0

QLocale german(QLocale::German);
d = german.toDouble(u"1234,56", &ok);  // ok == true,  d == 1234.56
d = german.toDouble(u"1.234,56", &ok); // ok == true,  d == 1234.56
d = german.toDouble(u"1234.56", &ok);  // ok == false, d == 0

d = german.toDouble(u"1.234", &ok);    // ok == true,  d == 1234.0

Observe que la última conversión devuelve 1234.0, porque '.' es el separador de grupos de miles en la configuración regional alemana.

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toFloat(), toInt() y toString().

double QLocale::toDouble(const QString &s, bool *ok = nullptr) const

Devuelve el doble representado por la cadena localizada s.

Devuelve un infinito si la conversión se desborda o 0,0 si la conversión falla por cualquier otro motivo (por ejemplo, desbordamiento por defecto).

Si ok no es nullptr, se informa del fallo estableciendo *ok en false, y del éxito estableciendo *ok en true.

bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble("1234.56", &ok);  // ok == true,  d == 1234.56
d = c.toDouble("1,234.56", &ok); // ok == true,  d == 1234.56
d = c.toDouble("1234,56", &ok);  // ok == false, d == 0

QLocale german(QLocale::German);
d = german.toDouble("1234,56", &ok);  // ok == true,  d == 1234.56
d = german.toDouble("1.234,56", &ok); // ok == true,  d == 1234.56
d = german.toDouble("1234.56", &ok);  // ok == false, d == 0

d = german.toDouble("1.234", &ok);    // ok == true,  d == 1234.0

Observe que la última conversión devuelve 1234.0, porque '.' es el separador de grupos de miles en la configuración regional alemana.

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toFloat(), toInt() y toString().

float QLocale::toFloat(QStringView s, bool *ok = nullptr) const

Devuelve el flotador representado por la cadena localizada s.

Devuelve un infinito si la conversión se desborda o 0,0 si la conversión falla por cualquier otro motivo (por ejemplo, desbordamiento por defecto).

Si ok no es nullptr, el fallo se notifica estableciendo *ok en false, y el éxito estableciendo *ok en true.

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toDouble(), toInt() y toString().

float QLocale::toFloat(const QString &s, bool *ok = nullptr) const

Devuelve el flotador representado por la cadena localizada s.

Devuelve un infinito si la conversión se desborda o 0,0 si la conversión falla por cualquier otro motivo (por ejemplo, desbordamiento por defecto).

Si ok no es nullptr, el fallo se notifica estableciendo *ok en false, y el éxito estableciendo *ok en true.

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toDouble(), toInt() y toString().

int QLocale::toInt(QStringView s, bool *ok = nullptr) const

Devuelve el int representado por la cadena localizada s.

Si la conversión falla, la función devuelve 0.

Si ok no es nullptr, el fallo se notifica estableciendo *ok en false, y el éxito estableciendo *ok en true.