.. highlightlang:: us

.. index:: DT_SetLocale

.. _dt_setlocale:

DT_SetLocale
============

.. us.tag  DT_SetLocale ENGLISH DT_FUNC

:ref:`DT_SetLocale` sets the time/date format for a language.

.. function::  ssOldLocale = DT_SetLocale()
    ssOldLocale = DT_SetLocale(ssLocale)
    OldLCID = DT_SetLocale(LCID)

.. us.return

**Return Value**

*ssOldLocale* is the old setting.

.. us.params

**Parameters**

.. uparam:: ssLocale

   The following language strings are recognized by :ref:`DT_SetLocale`. Any
   language not supported by the operating system is not accepted by
   :ref:`DT_SetLocale`. The three-letter language-string codes are only valid in
   Windows NT and Windows 95. To set the language setting for the
   :ref:`DT_ParseDateTime` function the LCID

.. uparam:: LCID

   To enable :ref:`DT_ParseDateTime` to parse date/time strings in a different
   language the *LCID* can be set. See the table below for values. The value -1
   sets it back to the default language.

.. us.comment

**Comment**

Default setting is the country setting of Windows.

.. list-table::
   :header-rows: 1

   * - Language
     - Locale
     - LCID
   * - Chinese
     - "chinese"
     - 0x0804
   * - Chinese (simplified)
     - "chinese-simplified" or "chs"
     - 
   * - Chinese (traditional)
     - "chinese-traditional" or "cht"
     - 
   * - Czech
     - "csy" or "czech"
     - 0x0405
   * - Danish
     - "dan" or "danish"
     - 0x0406
   * - Dutch (Belgian)
     - "belgian", "dutch-belgian", or "nlb"
     - 0x0813
   * - Dutch (default)
     - "dutch" or "nld"
     - 0x0413
   * - English (Australian)
     - "australian", "ena", or "english-aus"
     - 0x0c09
   * - English (Canadian)
     - "canadian", "enc", or "english-can"
     - 0x1009
   * - English (default)
     - "english"
     - 0x0809
   * - English (New Zealand)
     - "english-nz" or "enz"
     - 0x1409
   * - English (UK)
     - "eng", "english-uk", or "uk"
     - 0x0809
   * - English (USA)
     - "american", "american english", "american-english", "english-american", "english-us", "english-usa", "enu", "us", or "usa"
     - 0x0409
   * - Finnish
     - "fin" or "finnish"
     - 0x040b
   * - French (Belgian)
     - "frb" or "french-belgian"
     - 0x080c
   * - French (Canadian)
     - "frc" or "french-canadian"
     - 0x0c0c
   * - French (default)
     - "fra" or "french"
     - 0x040c
   * - French (Swiss)
     - "french-swiss" or "frs"
     - 0x100c
   * - German (Austrian)
     - "dea" or "german-austrian"
     - 0x0c07
   * - German (default)
     - "deu" or "german"
     - 0x0407
   * - German (Swiss)
     - "des", "german-swiss", or "swiss"
     - 0x0807
   * - Greek
     - "ell" or "greek"
     - 0x0408
   * - Hungarian
     - "hun" or "hungarian"
     - 0x040e
   * - Icelandic
     - "icelandic" or "isl"
     - 0x040f
   * - Italian (default)
     - "ita" or "italian"
     - 0x0410
   * - Italian (Swiss)
     - "italian-swiss" or "its"
     - 0x0810
   * - Japanese
     - "japanese" or "jpn"
     - 0x0411
   * - Korean
     - "kor" or "korean"
     - 0x0412
   * - Norwegian (Bokmal)
     - "nor" or "norwegian-bokmal"
     - 0x0414
   * - Norwegian (default)
     - "norwegian"
     - 0x0814
   * - Norwegian (Nynorsk)
     - "non" or "norwegian-nynorsk"
     - 0x0814
   * - Polish
     - "plk" or "polish"
     - 0x0415
   * - Portuguese (Brazilian)
     - "portuguese-brazilian" or "ptb"
     - 0x0416
   * - Portuguese (default)
     - "portuguese" or "ptg"
     - 0x0816
   * - Russian (default)
     - "rus" or "russian"
     - 0x0419
   * - Slovak
     - "sky" or "slovak"
     - 0x041b
   * - Spanish (default)
     - "esp" or "spanish"
     - 0x040a
   * - Spanish (Mexican)
     - "esm" or "spanish-mexican"
     - 0x080a
   * - Spanish (Modern)
     - "esn" or "spanish-modern"
     - 0x0c0a
   * - Swedish
     - "sve" or "swedish"
     - 0x041d
   * - Turkish
     - "trk" or "turkish"
     - 0x041f

.. seealso::
   :ref:`overview-date-and-time`,
   :ref:`DT_GetCurrentTime`,
   :ref:`DT_ParseDateTime`

:sub:`id-619090`