Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Classes principales  ·  Annotées  ·  Classes groupées  ·  Modules  ·  Fonctions  · 

Locale

The Locale object provides locale specific properties and formatted data. More...

Properties

Methods

Detailed Description

The Locale object may only be created via the Qt.locale() function. It cannot be created directly.

The Qt.locale() function returns a JS Locale object representing the locale with the specified name, which has the format "language[_territory][.codeset][@modifier]" or "C".

Locale supports the concept of a default locale, which is determined from the system's locale settings at application startup. If no parameter is passed to Qt.locale() the default locale object is returned.

The Locale object provides a number of functions and properties providing data for the specified locale.

The Locale object may also be passed to the Date and Number toLocaleString() and fromLocaleString() methods in order to convert to/from strings using the specified locale.

This example shows the current date formatted for the German locale:

 import QtQuick 2.0

 Text {
     text: "The date is: " + Date().toLocaleString(Qt.locale("de_DE"))
 }

The following example displays the specified number in the correct format for the default locale:

 import QtQuick 2.0

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

QtQuick Locale's data is based on Common Locale Data Repository v1.8.1.

The double-to-string and string-to-double conversion functions are covered by the following licenses:

Copyright (c) 1991 by AT&T.

Permission to use, copy, modify, and distribute this software for any purpose without fee is hereby granted, provided that this entire notice is included in all copies of any software which is or includes a copy or modification of this software and in all copies of the supporting documentation for such software.

THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED WARRANTY. IN PARTICULAR, NEITHER THE AUTHOR NOR AT&T MAKES ANY REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE.

This product includes software developed by the University of California, Berkeley and its contributors.

See also Date and Number.

Property Documentation

amText : string

The localized name of the "AM" suffix for times specified using the conventions of the 12-hour clock.


decimalPoint : string

Holds the decimal point character of this locale.


exponential : string

Holds the exponential character of this locale.


firstDayOfWeek : enumeration

Holds the first day of the week according to the current locale.

  • Locale.Sunday = 0
  • Locale.Monday = 1
  • Locale.Tuesday = 2
  • Locale.Wednesday = 3
  • Locale.Thursday = 4
  • Locale.Friday = 5
  • Locale.Saturday = 6

Note: that these values match the JS Date API which is different from the Qt C++ API where Qt::Sunday = 7.


groupSeparator : string

Holds the group separator character of this locale.


measurementSystem : enumeration

This property defines which units are used for measurement.

  • Locale.MetricSystem This value indicates metric units, such as meters, centimeters and millimeters.
  • Locale.ImperialSystem This value indicates imperial units, such as inches and miles. There are several distinct imperial systems in the world; this value stands for the official United States imperial units.

name : string

Holds the language and country of this locale as a string of the form "language_country", where language is a lowercase, two-letter ISO 639 language code, and country is an uppercase, two- or three-letter ISO 3166 country code.


nativeCountryName : string

Holds a native name of the country for the locale. For example "España" for Spanish/Spain locale.

See also nativeLanguageName.


nativeLanguageName : string

Holds a native name of the language for the locale. For example "Schwiizertüütsch" for Swiss-German locale.

See also nativeCountryName.


negativeSign : string

Holds the negative sign character of this locale.


percent : string

Holds the percent character of this locale.


pmText : string

The localized name of the "PM" suffix for times specified using the conventions of the 12-hour clock.


positiveSign : string

Holds the positive sign character of this locale.


textDirection : enumeration

Holds the text direction of the language:

  • Qt.LeftToRight
  • Qt.RightToLeft

uiLanguages : Array<string>

Returns an ordered list of locale names for translation purposes in preference order.

The return value represents locale names that the user expects to see the UI translation in.

The first item in the list is the most preferred one.


weekDays : Array<int>

Holds an array of days that are considered week days according to the current locale, where Sunday is 0 and Saturday is 6.

See also firstDayOfWeek.


zeroDigit : string

Holds Returns the zero digit character of this locale.


Method Documentation

string Locale::currencySymbol(format)

Returns the currency symbol for the specified format:

  • Locale.CurrencyIsoCode a ISO-4217 code of the currency.
  • Locale.CurrencySymbol a currency symbol.
  • Locale.CurrencyDisplayName a user readable name of the currency.

See also Number::toLocaleCurrencyString().


string Locale::dateFormat(type)

Returns the date format used for the current locale. type specifies the FormatType to return.

See also Date.


string Locale::dateTimeFormat(type)

Returns the date time format used for the current locale. type specifies the FormatType to return.

See also Date.


string Locale::dayName(day, type)

Returns the localized name of the day (where 0 represents Sunday, 1 represents Monday and so on), in the optional FormatType specified by type.

See also monthName() and standaloneDayName().


string Locale::monthName(month, type)

Returns the localized name of month (0-11), in the optional FortmatType specified by type.

Note: the QLocale C++ API expects a range of (1-12), however Locale.monthName() expects 0-11 as per the JS Date object.

See also dayName() and standaloneMonthName().


string Locale::standaloneDayName(day, type)

Returns the localized name of the day (where 0 represents Sunday, 1 represents Monday and so on) that is used as a standalone text, in the FormatType specified by type.

If the locale information does not specify the standalone day name then return value is the same as in dayName().

See also dayName() and standaloneMonthName().


string Locale::standaloneMonthName(month, type)

Returns the localized name of month (0-11) that is used as a standalone text, in the optional FormatType specified by type.

If the locale information doesn't specify the standalone month name then return value is the same as in monthName().

Note: the QLocale C++ API expects a range of (1-12), however Locale.standaloneMonthName() expects 0-11 as per the JS Date object.

See also monthName() and standaloneDayName().


string Locale::timeFormat(type)

Returns the time format used for the current locale. type specifies the FormatType to return.

See also Date.


Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 5.0-snapshot
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web