monday

package module
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 20, 2024 License: BSD-2-Clause Imports: 10 Imported by: 0

README

Description

Monday is a minimalistic translator for month and day of week names in time.Date objects. Supports 20+ different locales. Written in pure Go.

Go

Installing

go get github.com/kidbrains/monday

Usage

Format

Given that you already use time.Format somewhere in your code, to translate your output you should import monday and replace

  yourTime.Format(yourLayout)

with

  // Change LocaleEnUS to the locale you want to use for translation
  monday.Format(yourTime, yourLayout, monday.LocaleEnUS)

Parse

Given that you already use time.ParseInLocation somewhere in your code, to parse input string in a different language you should import monday and replace

  time.ParseInLocation(yourLayout, yourString, yourLocation)

with

  // Change LocaleEnUS to the locale you want to use for translation
  monday.ParseInLocation(yourLayout, yourString, yourLocation, monday.LocaleEnUS)

Predefined formats

Monday declares some predefined formats: Full, Long, Medium, Short, DateTime formats for each locale. E.g. to get short format for any locale you can use map:

monday.ShortFormatsByLocale[locale]

Usage notes

Monday is not an alternative to standard time package. It is a temporary solution to use while the internationalization features are not ready.

That's why monday doesn't create any additional parsing algorithms, layout identifiers. It is just a wrapper for time.Format and time.ParseInLocation and uses all the same layout IDs, constants, etc.

So, the changes you need to temporarily switch to monday (while the internationalization features are being developed) are minimal: you preserve your layout, your time object, your parsed date string formats and the only change is the func call itself.

Locales

Supported locales are listed in locale.go file.

const (
    LocaleEnUS = "en_US" // English (United States)
    LocaleEnGB = "en_GB" // English (United Kingdom)
    LocaleDaDK = "da_DK" // Danish (Denmark)
    LocaleNlBE = "nl_BE" // Dutch (Belgium)
    LocaleNlNL = "nl_NL" // Dutch (Netherlands)
    LocaleFiFI = "fi_FI" // Finnish (Finland)
    LocaleFrFR = "fr_FR" // French (France)
    LocaleFrCA = "fr_CA" // French (Canada)
    LocaleDeDE = "de_DE" // German (Germany)
    LocaleHuHU = "hu_HU" // Hungarian (Hungary)
    LocaleItIT = "it_IT" // Italian (Italy)
    LocaleNnNO = "nn_NO" // Norwegian Nynorsk (Norway)
    LocaleNbNO = "nb_NO" // Norwegian Bokmål (Norway)
    LocalePlPL = "pl_PL" // Polish (Poland)
    LocalePtPT = "pt_PT" // Portuguese (Portugal)
    LocalePtBR = "pt_BR" // Portuguese (Brazil)
    LocaleRoRO = "ro_RO" // Romanian (Romania)
    LocaleRuRU = "ru_RU" // Russian (Russia)
    LocaleEsES = "es_ES" // Spanish (Spain)
    LocaleCaES = "ca_ES" // Catalan (Spain)
    LocaleSvSE = "sv_SE" // Swedish (Sweden)
    LocaleTrTR = "tr_TR" // Turkish (Turkey)
    LocaleUkUA = "uk_UA" // Ukrainian (Ukraine)
    LocaleBgBG = "bg_BG" // Bulgarian (Bulgaria)
    LocaleZhCN = "zh_CN" // Chinese (Mainland)
    LocaleZhTW = "zh_TW" // Chinese (Taiwan)
    LocaleZhHK = "zh_HK" // Chinese (Hong Kong)
    LocaleKoKR = "ko_KR" // Korean (Korea)
    LocaleJaJP = "ja_JP" // Japanese (Japan)
    LocaleElGR = "el_GR" // Greek (Greece)
    LocaleIdID = "id_ID" // Indonesian (Indonesia)
    LocaleFrGP = "fr_GP" // French (Guadeloupe)
    LocaleFrLU = "fr_LU" // French (Luxembourg)
    LocaleFrMQ = "fr_MQ" // French (Martinique)
    LocaleFrGF = "fr_GF" // French (French Guiana)
    LocaleFrGF = "fr_RE" // French (Reunion)
    LocaleCsCZ = "cs_CZ" // Czech (Czech Republic)
    LocaleSlSI = "sl_SI" // Slovenian (Slovenia)
    LocaleLtLT = "lt_LT" // Lithuanian (Lithuania)
    LocaleHeIL = "he_IL" // Hebrew (Israel)
    LocaleArAE = "ar_AE" // Arabic (United Arab Emirates)
    LocaleHiIN = "hi_IN" // Hindi (India)
    LocaleAzAZ = "az_AZ" // Azerbaijani (Azerbaijan)
    LocaleViVN = "vi_VN" // Vietnamese (Vietnam)
    LocaleEtEE = "et_EE" // Estonian (Estonia)
    LocaleHrHR = "hr_HR" // Croatian (Croatia)
    LocaleLvLV = "lv_LV" // Latvian (Latvia)
    LocaleSkSK = "sk_SK" // Slovak (Slovakia)
    LocaleThTH = "th_TH" // Thai (Thailand)
    LocaleUzUZ = "uz_UZ" // Uzbek (Uzbekistan)
    LocaleKkKZ = "kk_KZ" // Kazakh (Kazakhstan)
)

LocaleDetector

    var timeLocaleDetector *monday.LocaleDetector = monday.NewLocaleDetector()
    dateTime, err := timeLocaleDetector.Parse(layout,datestr)

parses datetime with unknown locale (for now - layout must be defined, as for time.Parse())

useful for text parsing tools/crawlers (f.e.: rss-feeds crawler)

TODO:

  • make LocaleDetector insensitive to whitespaces count

Thread-safety

Monday initializes all its data once in the init func and then uses only func calls and local vars. Thus, it's thread-safe and doesn't need any mutexes to be used with.

Monday Licence

The Monday library is released under the BSD Licence

LICENCE file

Thanks

Documentation

Overview

Package monday is a minimalistic translator for month and day of week names in time.Date objects

Introduction

Monday is not an alternative to standard time package. It is a temporary solution to use while the internationalization features are not ready.

That's why monday doesn't create any additional parsing algorithms, layout identifiers. It is just a wrapper for time.Format and time.ParseInLocation and uses all the same layout IDs, constants, etc.

Usage

Format usage: 

t := time.Date(2013, 4, 12, 0, 0, 0, 0, time.UTC)
layout := "2 January 2006 15:04:05 MST"

translationEnUS := monday.Format(t, layout, monday.LocaleEnUS)  // Instead of t.Format(layout)
translationRuRU := monday.Format(t, layout, monday.LocaleRuRU)  // Instead of t.Format(layout)
...

Parse usage: 

layout := "2 January 2006 15:04:05 MST"

// Instead of time.ParseInLocation(layout, "12 April 2013 00:00:00 MST", time.UTC)
parsed := monday.ParseInLocation(layout, "12 April 2013 00:00:00 MST", time.UTC, monday.LocaleEnUS))
parsed2 = monday.ParseInLocation(layout, "12 апреля 2013 00:00:00 MST", time.UTC, monday.LocaleRuRU))
...

Thread safety

Monday initializes all its data once in the init func and then uses only func calls and local vars. Thus, it's thread-safe and doesn't need any mutexes to be used with.

Index

Examples

Constants

View Source 
const (
	DefaultFormatEnUS = "01/02/06"

	DefaultFormatEnUSFull     = "Monday, January 2, 2006" // English (United States)
	DefaultFormatEnUSLong     = "January 2, 2006"
	DefaultFormatEnUSMedium   = "Jan 02, 2006"
	DefaultFormatEnUSShort    = "1/2/06"
	DefaultFormatEnUSDateTime = "1/2/06 3:04 PM"
	DefaultFormatEnUSTime     = "3:04 PM"

	DefaultFormatEnGBFull     = "Monday, 2 January 2006" // English (United Kingdom)
	DefaultFormatEnGBLong     = "2 January 2006"
	DefaultFormatEnGBMedium   = "02 Jan 2006"
	DefaultFormatEnGBShort    = "02/01/2006"
	DefaultFormatEnGBDateTime = "02/01/2006 15:04"
	DefaultFormatEnGBTime     = "15:04"

	DefaultFormatDaDKFull     = "Monday den 2. January 2006" // Danish (Denmark)
	DefaultFormatDaDKLong     = "2. Jan 2006"
	DefaultFormatDaDKMedium   = "02/01/2006"
	DefaultFormatDaDKShort    = "02/01/06"
	DefaultFormatDaDKDateTime = "02/01/2006 15.04"
	DefaultFormatDaDKTime     = "15.04"

	DefaultFormatNlBEFull     = "Monday 2 January 2006" // Dutch (Belgium)
	DefaultFormatNlBELong     = "2 January 2006"
	DefaultFormatNlBEMedium   = "02-Jan-2006"
	DefaultFormatNlBEShort    = "2/01/06"
	DefaultFormatNlBEDateTime = "2/01/06 15:04"
	DefaultFormatNlBETime     = "15:04"

	DefaultFormatNlNLFull     = "Monday 2 January 2006" // Dutch (Netherlands)
	DefaultFormatNlNLLong     = "2 January 2006"
	DefaultFormatNlNLMedium   = "02 Jan 2006"
	DefaultFormatNlNLShort    = "02-01-06"
	DefaultFormatNlNLDateTime = "02-01-06 15:04"
	DefaultFormatNlNLTime     = "15:04"

	DefaultFormatFiFIFull     = "Monday 2. January 2006" // Finnish (Finland)
	DefaultFormatFiFILong     = "2. January 2006"
	DefaultFormatFiFIMedium   = "02.1.2006"
	DefaultFormatFiFIShort    = "02.1.2006"
	DefaultFormatFiFIDateTime = "02.1.2006 15.04"
	DefaultFormatFiFITime     = "15.04"

	DefaultFormatFrFRFull     = "Monday 2 January 2006" // French (France)
	DefaultFormatFrFRLong     = "2 January 2006"
	DefaultFormatFrFRMedium   = "02 Jan 2006"
	DefaultFormatFrFRShort    = "02/01/2006"
	DefaultFormatFrFRDateTime = "02/01/2006 15:04"
	DefaultFormatFrFRTime     = "15:04"

	DefaultFormatFrCAFull     = "Monday 2 January 2006" // French (Canada)
	DefaultFormatFrCALong     = "2 January 2006"
	DefaultFormatFrCAMedium   = "2006-01-02"
	DefaultFormatFrCAShort    = "06-01-02"
	DefaultFormatFrCADateTime = "06-01-02 15:04"
	DefaultFormatFrCATime     = "15:04"

	DefaultFormatFrGPFull     = "Monday 2 January 2006" // French (Guadeloupe)
	DefaultFormatFrGPLong     = "2 January 2006"
	DefaultFormatFrGPMedium   = "2006-01-02"
	DefaultFormatFrGPShort    = "06-01-02"
	DefaultFormatFrGPDateTime = "06-01-02 15:04"
	DefaultFormatFrGPTime     = "15:04"

	DefaultFormatFrLUFull     = "Monday 2 January 2006" // French (Luxembourg)
	DefaultFormatFrLULong     = "2 January 2006"
	DefaultFormatFrLUMedium   = "2006-01-02"
	DefaultFormatFrLUShort    = "06-01-02"
	DefaultFormatFrLUDateTime = "06-01-02 15:04"
	DefaultFormatFrLUTime     = "15:04"

	DefaultFormatFrMQFull     = "Monday 2 January 2006" // French (Martinique)
	DefaultFormatFrMQLong     = "2 January 2006"
	DefaultFormatFrMQMedium   = "2006-01-02"
	DefaultFormatFrMQShort    = "06-01-02"
	DefaultFormatFrMQDateTime = "06-01-02 15:04"
	DefaultFormatFrMQTime     = "15:04"

	DefaultFormatFrGFFull     = "Monday 2 January 2006" // French (French Guiana)
	DefaultFormatFrGFLong     = "2 January 2006"
	DefaultFormatFrGFMedium   = "2006-01-02"
	DefaultFormatFrGFShort    = "06-01-02"
	DefaultFormatFrGFDateTime = "06-01-02 15:04"
	DefaultFormatFrGFTime     = "15:04"

	DefaultFormatFrREFull     = "Monday 2 January 2006" // French (Reunion)
	DefaultFormatFrRELong     = "2 January 2006"
	DefaultFormatFrREMedium   = "2006-01-02"
	DefaultFormatFrREShort    = "06-01-02"
	DefaultFormatFrREDateTime = "06-01-02 15:04"
	DefaultFormatFrRETime     = "15:04"

	DefaultFormatDeDEFull     = "Monday, 2. January 2006" // German (Germany)
	DefaultFormatDeDELong     = "2. January 2006"
	DefaultFormatDeDEMedium   = "02.01.2006"
	DefaultFormatDeDEShort    = "02.01.06"
	DefaultFormatDeDEDateTime = "02.01.06 15:04"
	DefaultFormatDeDETime     = "15:04"

	DefaultFormatHuHUFull     = "2006. January 2., Monday" // Hungarian (Hungary)
	DefaultFormatHuHULong     = "2006. January 2."
	DefaultFormatHuHUMedium   = "2006.01.02."
	DefaultFormatHuHUShort    = "2006.01.02."
	DefaultFormatHuHUDateTime = "2006.01.02. 15:04"
	DefaultFormatHuHUTime     = "15:04"

	DefaultFormatItITFull     = "Monday 2 January 2006" // Italian (Italy)
	DefaultFormatItITLong     = "2 January 2006"
	DefaultFormatItITMedium   = "02/Jan/2006"
	DefaultFormatItITShort    = "02/01/06"
	DefaultFormatItITDateTime = "02/01/06 15:04"
	DefaultFormatItITTime     = "15:04"

	DefaultFormatNnNOFull     = "Monday 2. January 2006" // Norwegian Nynorsk (Norway)
	DefaultFormatNnNOLong     = "2. January 2006"
	DefaultFormatNnNOMedium   = "02. Jan 2006"
	DefaultFormatNnNOShort    = "02.01.06"
	DefaultFormatNnNODateTime = "02.01.06 15:04"
	DefaultFormatNnNOTime     = "15:04"

	DefaultFormatNbNOFull     = "Monday 2. January 2006" // Norwegian Bokmål (Norway)
	DefaultFormatNbNOLong     = "2. January 2006"
	DefaultFormatNbNOMedium   = "02. Jan 2006"
	DefaultFormatNbNOShort    = "02.01.06"
	DefaultFormatNbNODateTime = "15:04 02.01.06"
	DefaultFormatNbNOTime     = "15:04"

	DefaultFormatPtPTFull     = "Monday, 2 de January de 2006" // Portuguese (Portugal)
	DefaultFormatPtPTLong     = "2 de January de 2006"
	DefaultFormatPtPTMedium   = "02/01/2006"
	DefaultFormatPtPTShort    = "02/01/06"
	DefaultFormatPtPTDateTime = "02/01/06, 15:04"
	DefaultFormatPtPTTime     = "15:04"

	DefaultFormatPtBRFull     = "Monday, 2 de January de 2006" // Portuguese (Brazil)
	DefaultFormatPtBRLong     = "02 de January de 2006"
	DefaultFormatPtBRMedium   = "02/01/2006"
	DefaultFormatPtBRShort    = "02/01/06"
	DefaultFormatPtBRDateTime = "02/01/06, 15:04"
	DefaultFormatPtBRTime     = "15:04"

	DefaultFormatRoROFull     = "Monday, 02 January 2006" // Romanian (Romania)
	DefaultFormatRoROLong     = "02 January 2006"
	DefaultFormatRoROMedium   = "02.01.2006"
	DefaultFormatRoROShort    = "02.01.2006"
	DefaultFormatRoRODateTime = "02.01.06, 15:04"
	DefaultFormatRoROTime     = "15:04"

	DefaultFormatRuRUFull     = "Monday, 2 January 2006 г." // Russian (Russia)
	DefaultFormatRuRULong     = "2 January 2006 г."
	DefaultFormatRuRUMedium   = "02 Jan 2006 г."
	DefaultFormatRuRUShort    = "02.01.06"
	DefaultFormatRuRUDateTime = "02.01.06, 15:04"
	DefaultFormatRuRUTime     = "15:04"

	DefaultFormatEsESFull     = "Monday, 2 de January de 2006" // Spanish (Spain)
	DefaultFormatEsESLong     = "2 de January de 2006"
	DefaultFormatEsESMedium   = "02/01/2006"
	DefaultFormatEsESShort    = "02/01/06"
	DefaultFormatEsESDateTime = "02/01/06 15:04"
	DefaultFormatEsESTime     = "15:04"

	DefaultFormatCaESFull     = "Monday, 2 de January de 2006" // Spanish (Spain)
	DefaultFormatCaESLong     = "2 de January de 2006"
	DefaultFormatCaESMedium   = "02/01/2006"
	DefaultFormatCaESShort    = "02/01/06"
	DefaultFormatCaESDateTime = "02/01/06 15:04"
	DefaultFormatCaESTime     = "15:04"

	DefaultFormatSvSEFull     = "Mondayen den 2:e January 2006" // Swedish (Sweden)
	DefaultFormatSvSELong     = "2 January 2006"
	DefaultFormatSvSEMedium   = "2 Jan 2006"
	DefaultFormatSvSEShort    = "2006-01-02"
	DefaultFormatSvSEDateTime = "2006-01-02 15:04"
	DefaultFormatSvSETime     = "15:04"

	DefaultFormatTrTRFull     = "2 January 2006 Monday" // Turkish (Turkey)
	DefaultFormatTrTRLong     = "2 January 2006"
	DefaultFormatTrTRMedium   = "2 Jan 2006"
	DefaultFormatTrTRShort    = "2.01.2006"
	DefaultFormatTrTRDateTime = "2.01.2006 15:04"
	DefaultFormatTrTRTime     = "15:04"

	DefaultFormatUkUAFull     = "Monday, 2 January 2006 р." // Ukrainian (Ukraine)
	DefaultFormatUkUALong     = "2 January 2006 р."
	DefaultFormatUkUAMedium   = "02 Jan 2006 р."
	DefaultFormatUkUAShort    = "02.01.06"
	DefaultFormatUkUADateTime = "02.01.06, 15:04"
	DefaultFormatUkUATime     = "15:04"

	DefaultFormatBgBGFull     = "Monday, 2 January 2006" // Bulgarian (Bulgaria)
	DefaultFormatBgBGLong     = "2 January 2006"
	DefaultFormatBgBGMedium   = "2 Jan 2006"
	DefaultFormatBgBGShort    = "2.01.2006"
	DefaultFormatBgBGDateTime = "2.01.2006 15:04"
	DefaultFormatBgBGTime     = "15:04"

	DefaultFormatZhCNFull     = "2006年1月2日 Monday" // Chinese (Mainland)
	DefaultFormatZhCNLong     = "2006年1月2日"
	DefaultFormatZhCNMedium   = "2006-01-02"
	DefaultFormatZhCNShort    = "2006/1/2"
	DefaultFormatZhCNDateTime = "2006-01-02 15:04"
	DefaultFormatZhCNTime     = "15:04"

	DefaultFormatZhTWFull     = "2006年1月2日 Monday" // Chinese (Taiwan)
	DefaultFormatZhTWLong     = "2006年1月2日"
	DefaultFormatZhTWMedium   = "2006-01-02"
	DefaultFormatZhTWShort    = "2006/1/2"
	DefaultFormatZhTWDateTime = "2006-01-02 15:04"
	DefaultFormatZhTWTime     = "15:04"

	DefaultFormatZhHKFull     = "2006年1月2日 Monday" // Chinese (Hong Kong)
	DefaultFormatZhHKLong     = "2006年1月2日"
	DefaultFormatZhHKMedium   = "2006-01-02"
	DefaultFormatZhHKShort    = "2006/1/2"
	DefaultFormatZhHKDateTime = "2006-01-02 15:04"
	DefaultFormatZhHKTime     = "15:04"

	DefaultFormatKoKRFull     = "2006년1월2일 월요일" // Korean (Korea)
	DefaultFormatKoKRLong     = "2006년1월2일"
	DefaultFormatKoKRMedium   = "2006-01-02"
	DefaultFormatKoKRShort    = "2006/1/2"
	DefaultFormatKoKRDateTime = "2006-01-02 15:04"
	DefaultFormatKoKRTime     = "15:04"

	DefaultFormatJaJPFull     = "2006年1月2日 Monday" // Japanese (Japan)
	DefaultFormatJaJPLong     = "2006年1月2日"
	DefaultFormatJaJPMedium   = "2006/01/02"
	DefaultFormatJaJPShort    = "2006/1/2"
	DefaultFormatJaJPDateTime = "2006/01/02 15:04"
	DefaultFormatJaJPTime     = "15:04"

	DefaultFormatElGRFull     = "Monday, 2 January 2006" // Greek (Greece)
	DefaultFormatElGRLong     = "2 January 2006"
	DefaultFormatElGRMedium   = "2 Jan 2006"
	DefaultFormatElGRShort    = "02/01/06"
	DefaultFormatElGRDateTime = "02/01/06 15:04"
	DefaultFormatElGRTime     = "15:04"

	DefaultFormatCsCZFull     = "Monday, 2. January 2006" // Czech (Czech Republic)
	DefaultFormatCsCZLong     = "2. January 2006"
	DefaultFormatCsCZMedium   = "02 Jan 2006"
	DefaultFormatCsCZShort    = "02/01/2006"
	DefaultFormatCsCZDateTime = "02/01/2006 15:04"
	DefaultFormatCsCZTime     = "15:04"

	DefaultFormatLtLTFull     = "2006 m. January 2 d., Monday" // Lithuanian (Lithuania)
	DefaultFormatLtLTLong     = "2006 January 2 d."
	DefaultFormatLtLTMedium   = "2006 Jan 2"
	DefaultFormatLtLTShort    = "2006-01-02"
	DefaultFormatLtLTDateTime = "2006-01-02, 15:04"
	DefaultFormatLtLTTime     = "15:04"

	DefaultFormatHeILFull     = "Monday, 2 January 2006" // Hebrew (Israel)
	DefaultFormatHeILLong     = "January 2006 2"
	DefaultFormatHeILMedium   = "Jan 2006 2"
	DefaultFormatHeILShort    = "2.1.2006"
	DefaultFormatHeILDateTime = "2.1.2006, 15:04"
	DefaultFormatHeILTime     = "15:04"

	DefaultFormatArAEFull     = "Monday، 2 January، 2006" // Arabic (United Arab Emirates)
	DefaultFormatArAELong     = "2 January، 2006"
	DefaultFormatArAEMedium   = "2 Jan، 2006"
	DefaultFormatArAEShort    = "2/1/2006"
	DefaultFormatArAEDateTime = "2/1/2006 15:04"
	DefaultFormatArAETime     = "15:04"

	DefaultFormatHiINFull     = "Monday، 2 January 2006" // Hindi (India)
	DefaultFormatHiINLong     = "2 January 2006"
	DefaultFormatHiINMedium   = "2 Jan 2006"
	DefaultFormatHiINShort    = "2/1/2006"
	DefaultFormatHiINDateTime = "2/1/2006, 15:04"
	DefaultFormatHiINTime     = "15:04"

	DefaultFormatAzAZFull     = "2 January 2006, Monday" // Azerbaijani (Azerbaijan)
	DefaultFormatAzAZLong     = "2 January 2006"
	DefaultFormatAzAZMedium   = "2 Jan 2006"
	DefaultFormatAzAZShort    = "2.1.2006"
	DefaultFormatAzAZDateTime = "2.1.2006 15:04"
	DefaultFormatAzAZTime     = "15:04"

	DefaultFormatViVNFull     = "Monday, ngày 2 January năm 2006" // Vietnamese (Vietnam)
	DefaultFormatViVNLong     = "2 January, 2006"
	DefaultFormatViVNMedium   = "2 Jan, 2006"
	DefaultFormatViVNShort    = "2/1/2006"
	DefaultFormatViVNDateTime = "15:04, 2/1/2006"
	DefaultFormatViVNTime     = "15:04"

	DefaultFormatEtEEFull     = "Monday, 2. January 2006" // Estonian (Estonia)
	DefaultFormatEtEELong     = "2. January 2006"
	DefaultFormatEtEEMedium   = "2. Jan 2006"
	DefaultFormatEtEEShort    = "2.1.2006"
	DefaultFormatEtEEDateTime = "2.1.2006 15:04"
	DefaultFormatEtEETime     = "2.1.2006 15:04"

	DefaultFormatHrHRFull     = "Monday, 2. January 2006." // Croatian (Croatia)
	DefaultFormatHrHRLong     = "2. January 2006."
	DefaultFormatHrHRMedium   = "2. Jan 2006."
	DefaultFormatHrHRShort    = "2.1.2006."
	DefaultFormatHrHRDateTime = "2.1.2006. 15:04"
	DefaultFormatHrHRTime     = "15:04"

	DefaultFormatLvLVFull     = "Monday, 2006. gada 2. January" // Latvian (Latvia)
	DefaultFormatLvLVLong     = "2006. gada 2. January"
	DefaultFormatLvLVMedium   = "2006. g. 2. Jan."
	DefaultFormatLvLVShort    = "2.1.2006."
	DefaultFormatLvLVDateTime = "2.1.2006. 15:04"
	DefaultFormatLvLVTime     = "15:04"

	DefaultFormatSkSKFull     = "Monday, 2. January 2006" // Slovak (Slovakia)
	DefaultFormatSkSKLong     = "2. January 2006"
	DefaultFormatSkSKMedium   = "2. 1. 2006"
	DefaultFormatSkSKShort    = "2. 1. 2006"
	DefaultFormatSkSKDateTime = "2. 1. 2006, 15:04"
	DefaultFormatSkSKTime     = "15:04"

	DefaultFormatThTHFull     = "Monday ที่ 2 January 2006" // Thai (Thailand)
	DefaultFormatThTHLong     = "วันที่ 2 January 2006"
	DefaultFormatThTHMedium   = "2 Jan 2006"
	DefaultFormatThTHShort    = "02/01/2006"
	DefaultFormatThTHDateTime = "02/01/2006 15:04"
	DefaultFormatThTHTime     = "15:04"

	DefaultFormatUzUZFull     = "Monday, 02 January 2006" // Uzbek (Uzbekistan)
	DefaultFormatUzUZLong     = "2 January 2006"
	DefaultFormatUzUZMedium   = "2 Jan 2006"
	DefaultFormatUzUZShort    = "02.01.2006"
	DefaultFormatUzUZDateTime = "02.01.2006 15:04"
	DefaultFormatUzUZTime     = "15:04"

	DefaultFormatKkKZFull     = "Monday, 2 January 2006 ж." // Kazakh (Kazakhstan)
	DefaultFormatKkKZLong     = "2 January 2006 ж."
	DefaultFormatKkKZMedium   = "02 Jan 2006 ж."
	DefaultFormatKkKZShort    = "02.01.06"
	DefaultFormatKkKZDateTime = "02.01.06, 15:04"
	DefaultFormatKkKZTime     = "15:04"
)

Default date formats by country. Mostly taken from http://en.wikipedia.org/wiki/Date_format_by_country

View Source 
const (
	LocaleEnUS = "en_US" // English (United States)
	LocaleEnGB = "en_GB" // English (United Kingdom)
	LocaleDaDK = "da_DK" // Danish (Denmark)
	LocaleNlBE = "nl_BE" // Dutch (Belgium)
	LocaleNlNL = "nl_NL" // Dutch (Netherlands)
	LocaleFiFI = "fi_FI" // Finnish (Finland)
	LocaleFrFR = "fr_FR" // French (France)
	LocaleFrCA = "fr_CA" // French (Canada)
	LocaleDeDE = "de_DE" // German (Germany)
	LocaleHuHU = "hu_HU" // Hungarian (Hungary)
	LocaleItIT = "it_IT" // Italian (Italy)
	LocaleNnNO = "nn_NO" // Norwegian Nynorsk (Norway)
	LocaleNbNO = "nb_NO" // Norwegian Bokmål (Norway)
	LocalePlPL = "pl_PL" // Polish (Poland)
	LocalePtPT = "pt_PT" // Portuguese (Portugal)
	LocalePtBR = "pt_BR" // Portuguese (Brazil)
	LocaleRoRO = "ro_RO" // Romanian (Romania)
	LocaleRuRU = "ru_RU" // Russian (Russia)
	LocaleEsES = "es_ES" // Spanish (Spain)
	LocaleCaES = "ca_ES" // Catalan (Spain)
	LocaleSvSE = "sv_SE" // Swedish (Sweden)
	LocaleTrTR = "tr_TR" // Turkish (Turkey)
	LocaleUkUA = "uk_UA" // Ukrainian (Ukraine)
	LocaleBgBG = "bg_BG" // Bulgarian (Bulgaria)
	LocaleZhCN = "zh_CN" // Chinese (Mainland)
	LocaleZhTW = "zh_TW" // Chinese (Taiwan)
	LocaleZhHK = "zh_HK" // Chinese (Hong Kong)
	LocaleKoKR = "ko_KR" // Korean (Korea)
	LocaleJaJP = "ja_JP" // Japanese (Japan)
	LocaleElGR = "el_GR" // Greek (Greece)
	LocaleIdID = "id_ID" // Indonesian (Indonesia)
	LocaleFrGP = "fr_GP" // French (Guadeloupe)
	LocaleFrLU = "fr_LU" // French (Luxembourg)
	LocaleFrMQ = "fr_MQ" // French (Martinique)
	LocaleFrRE = "fr_RE" // French (Reunion)
	LocaleFrGF = "fr_GF" // French (French Guiana)
	LocaleCsCZ = "cs_CZ" // Czech (Czech Republic)
	LocaleSlSI = "sl_SI" // Slovenian (Slovenia)
	LocaleLtLT = "lt_LT" // Lithuanian (Lithuania)
	LocaleHeIL = "he_IL" // Hebrew (Israel)
	LocaleArAE = "ar_AE" // Arabic (United Arab Emirates)
	LocaleHiIN = "hi_IN" // Hindi (India)
	LocaleAzAZ = "az_AZ" // Azerbaijani (Azerbaijan)
	LocaleViVN = "vi_VN" // Vietnamese (Vietnam)
	LocaleEtEE = "et_EE" // Estonian (Estonia)
	LocaleHrHR = "hr_HR" // Croatian (Croatia)
	LocaleLvLV = "lv_LV" // Latvian (Latvia)
	LocaleSkSK = "sk_SK" // Slovak (Slovakia)
	LocaleThTH = "th_TH" // Thai (Thailand)
	LocaleUzUZ = "uz_UZ" // Uzbek (Uzbekistan)
	LocaleKkKZ = "kk_KZ" // Kazakh (Kazakhstan)
)

Locale constants represent all locales that are currently supported by this package.

Variables

View Source 
var DateTimeFormatsByLocale = map[Locale]string{
	LocaleEnUS: DefaultFormatEnUSDateTime,
	LocaleEnGB: DefaultFormatEnGBDateTime,
	LocaleDaDK: DefaultFormatDaDKDateTime,
	LocaleNlBE: DefaultFormatNlBEDateTime,
	LocaleNlNL: DefaultFormatNlNLDateTime,
	LocaleFiFI: DefaultFormatFiFIDateTime,
	LocaleFrFR: DefaultFormatFrFRDateTime,
	LocaleFrCA: DefaultFormatFrCADateTime,
	LocaleFrGP: DefaultFormatFrGPDateTime,
	LocaleFrLU: DefaultFormatFrLUDateTime,
	LocaleFrMQ: DefaultFormatFrMQDateTime,
	LocaleFrGF: DefaultFormatFrGFDateTime,
	LocaleFrRE: DefaultFormatFrREDateTime,
	LocaleDeDE: DefaultFormatDeDEDateTime,
	LocaleHuHU: DefaultFormatHuHUDateTime,
	LocaleItIT: DefaultFormatItITDateTime,
	LocaleNnNO: DefaultFormatNnNODateTime,
	LocaleNbNO: DefaultFormatNbNODateTime,
	LocalePtPT: DefaultFormatPtPTDateTime,
	LocalePtBR: DefaultFormatPtBRDateTime,
	LocaleRoRO: DefaultFormatRoRODateTime,
	LocaleRuRU: DefaultFormatRuRUDateTime,
	LocaleEsES: DefaultFormatEsESDateTime,
	LocaleCaES: DefaultFormatCaESDateTime,
	LocaleSvSE: DefaultFormatSvSEDateTime,
	LocaleTrTR: DefaultFormatTrTRDateTime,
	LocaleBgBG: DefaultFormatBgBGDateTime,
	LocaleZhCN: DefaultFormatZhCNDateTime,
	LocaleZhTW: DefaultFormatZhTWDateTime,
	LocaleZhHK: DefaultFormatZhHKDateTime,
	LocaleKoKR: DefaultFormatKoKRDateTime,
	LocaleJaJP: DefaultFormatJaJPDateTime,
	LocaleElGR: DefaultFormatElGRDateTime,
	LocaleCsCZ: DefaultFormatCsCZDateTime,
	LocaleUkUA: DefaultFormatUkUADateTime,
	LocaleLtLT: DefaultFormatLtLTDateTime,
	LocaleHeIL: DefaultFormatHeILDateTime,
	LocaleArAE: DefaultFormatArAEDateTime,
	LocaleHiIN: DefaultFormatHiINDateTime,
	LocaleAzAZ: DefaultFormatAzAZDateTime,
	LocaleViVN: DefaultFormatViVNDateTime,
	LocaleEtEE: DefaultFormatEtEEDateTime,
	LocaleHrHR: DefaultFormatHrHRDateTime,
	LocaleLvLV: DefaultFormatLvLVDateTime,
	LocaleSkSK: DefaultFormatSkSKDateTime,
	LocaleUzUZ: DefaultFormatUzUZDateTime,
	LocaleKkKZ: DefaultFormatKkKZDateTime,
}

DateTimeFormatsByLocale maps locales to the 'DateTime' date formats for all supported locales.

View Source 
var FullFormatsByLocale = map[Locale]string{
	LocaleEnUS: DefaultFormatEnUSFull,
	LocaleEnGB: DefaultFormatEnGBFull,
	LocaleDaDK: DefaultFormatDaDKFull,
	LocaleNlBE: DefaultFormatNlBEFull,
	LocaleNlNL: DefaultFormatNlNLFull,
	LocaleFiFI: DefaultFormatFiFIFull,
	LocaleFrFR: DefaultFormatFrFRFull,
	LocaleFrCA: DefaultFormatFrCAFull,
	LocaleFrGP: DefaultFormatFrGPFull,
	LocaleFrLU: DefaultFormatFrLUFull,
	LocaleFrMQ: DefaultFormatFrMQFull,
	LocaleFrGF: DefaultFormatFrGFFull,
	LocaleFrRE: DefaultFormatFrREFull,
	LocaleDeDE: DefaultFormatDeDEFull,
	LocaleHuHU: DefaultFormatHuHUFull,
	LocaleItIT: DefaultFormatItITFull,
	LocaleNnNO: DefaultFormatNnNOFull,
	LocaleNbNO: DefaultFormatNbNOFull,
	LocalePtPT: DefaultFormatPtPTFull,
	LocalePtBR: DefaultFormatPtBRFull,
	LocaleRoRO: DefaultFormatRoROFull,
	LocaleRuRU: DefaultFormatRuRUFull,
	LocaleEsES: DefaultFormatEsESFull,
	LocaleCaES: DefaultFormatCaESFull,
	LocaleSvSE: DefaultFormatSvSEFull,
	LocaleTrTR: DefaultFormatTrTRFull,
	LocaleBgBG: DefaultFormatBgBGFull,
	LocaleZhCN: DefaultFormatZhCNFull,
	LocaleZhTW: DefaultFormatZhTWFull,
	LocaleZhHK: DefaultFormatZhHKFull,
	LocaleKoKR: DefaultFormatKoKRFull,
	LocaleJaJP: DefaultFormatJaJPFull,
	LocaleElGR: DefaultFormatElGRFull,
	LocaleCsCZ: DefaultFormatCsCZFull,
	LocaleUkUA: DefaultFormatUkUAFull,
	LocaleLtLT: DefaultFormatLtLTFull,
	LocaleHeIL: DefaultFormatHeILFull,
	LocaleArAE: DefaultFormatArAEFull,
	LocaleHiIN: DefaultFormatHiINFull,
	LocaleAzAZ: DefaultFormatAzAZFull,
	LocaleViVN: DefaultFormatViVNFull,
	LocaleEtEE: DefaultFormatEtEEFull,
	LocaleHrHR: DefaultFormatHrHRFull,
	LocaleLvLV: DefaultFormatLvLVFull,
	LocaleSkSK: DefaultFormatSkSKFull,
	LocaleThTH: DefaultFormatThTHFull,
	LocaleUzUZ: DefaultFormatUzUZFull,
	LocaleKkKZ: DefaultFormatKkKZFull,
}

FullFormatsByLocale maps locales to the'full' date formats for all supported locales.

View Source 
var LongFormatsByLocale = map[Locale]string{
	LocaleEnUS: DefaultFormatEnUSLong,
	LocaleEnGB: DefaultFormatEnGBLong,
	LocaleDaDK: DefaultFormatDaDKLong,
	LocaleNlBE: DefaultFormatNlBELong,
	LocaleNlNL: DefaultFormatNlNLLong,
	LocaleFiFI: DefaultFormatFiFILong,
	LocaleFrFR: DefaultFormatFrFRLong,
	LocaleFrCA: DefaultFormatFrCALong,
	LocaleFrGP: DefaultFormatFrGPLong,
	LocaleFrLU: DefaultFormatFrLULong,
	LocaleFrMQ: DefaultFormatFrMQLong,
	LocaleFrRE: DefaultFormatFrRELong,
	LocaleFrGF: DefaultFormatFrGFLong,
	LocaleDeDE: DefaultFormatDeDELong,
	LocaleHuHU: DefaultFormatHuHULong,
	LocaleItIT: DefaultFormatItITLong,
	LocaleNnNO: DefaultFormatNnNOLong,
	LocaleNbNO: DefaultFormatNbNOLong,
	LocalePtPT: DefaultFormatPtPTLong,
	LocalePtBR: DefaultFormatPtBRLong,
	LocaleRoRO: DefaultFormatRoROLong,
	LocaleRuRU: DefaultFormatRuRULong,
	LocaleEsES: DefaultFormatEsESLong,
	LocaleCaES: DefaultFormatCaESLong,
	LocaleSvSE: DefaultFormatSvSELong,
	LocaleTrTR: DefaultFormatTrTRLong,
	LocaleBgBG: DefaultFormatBgBGLong,
	LocaleZhCN: DefaultFormatZhCNLong,
	LocaleZhTW: DefaultFormatZhTWLong,
	LocaleZhHK: DefaultFormatZhHKLong,
	LocaleKoKR: DefaultFormatKoKRLong,
	LocaleJaJP: DefaultFormatJaJPLong,
	LocaleElGR: DefaultFormatElGRLong,
	LocaleCsCZ: DefaultFormatCsCZLong,
	LocaleUkUA: DefaultFormatUkUALong,
	LocaleLtLT: DefaultFormatLtLTLong,
	LocaleHeIL: DefaultFormatHeILLong,
	LocaleArAE: DefaultFormatArAELong,
	LocaleHiIN: DefaultFormatHiINLong,
	LocaleAzAZ: DefaultFormatAzAZLong,
	LocaleViVN: DefaultFormatViVNLong,
	LocaleEtEE: DefaultFormatEtEELong,
	LocaleHrHR: DefaultFormatHrHRLong,
	LocaleLvLV: DefaultFormatLvLVLong,
	LocaleSkSK: DefaultFormatSkSKLong,
	LocaleThTH: DefaultFormatThTHLong,
	LocaleUzUZ: DefaultFormatUzUZLong,
	LocaleKkKZ: DefaultFormatKkKZLong,
}

LongFormatsByLocale maps locales to the 'long' date formats for all supported locales.

View Source 
var MediumFormatsByLocale = map[Locale]string{
	LocaleEnUS: DefaultFormatEnUSMedium,
	LocaleEnGB: DefaultFormatEnGBMedium,
	LocaleDaDK: DefaultFormatDaDKMedium,
	LocaleNlBE: DefaultFormatNlBEMedium,
	LocaleNlNL: DefaultFormatNlNLMedium,
	LocaleFiFI: DefaultFormatFiFIMedium,
	LocaleFrFR: DefaultFormatFrFRMedium,
	LocaleFrGP: DefaultFormatFrGPMedium,
	LocaleFrCA: DefaultFormatFrCAMedium,
	LocaleFrLU: DefaultFormatFrLUMedium,
	LocaleFrMQ: DefaultFormatFrMQMedium,
	LocaleFrGF: DefaultFormatFrGFMedium,
	LocaleFrRE: DefaultFormatFrREMedium,
	LocaleDeDE: DefaultFormatDeDEMedium,
	LocaleHuHU: DefaultFormatHuHUMedium,
	LocaleItIT: DefaultFormatItITMedium,
	LocaleNnNO: DefaultFormatNnNOMedium,
	LocaleNbNO: DefaultFormatNbNOMedium,
	LocalePtPT: DefaultFormatPtPTMedium,
	LocalePtBR: DefaultFormatPtBRMedium,
	LocaleRoRO: DefaultFormatRoROMedium,
	LocaleRuRU: DefaultFormatRuRUMedium,
	LocaleEsES: DefaultFormatEsESMedium,
	LocaleCaES: DefaultFormatCaESMedium,
	LocaleSvSE: DefaultFormatSvSEMedium,
	LocaleTrTR: DefaultFormatTrTRMedium,
	LocaleBgBG: DefaultFormatBgBGMedium,
	LocaleZhCN: DefaultFormatZhCNMedium,
	LocaleZhTW: DefaultFormatZhTWMedium,
	LocaleZhHK: DefaultFormatZhHKMedium,
	LocaleKoKR: DefaultFormatKoKRMedium,
	LocaleJaJP: DefaultFormatJaJPMedium,
	LocaleElGR: DefaultFormatElGRMedium,
	LocaleCsCZ: DefaultFormatCsCZMedium,
	LocaleUkUA: DefaultFormatUkUAMedium,
	LocaleLtLT: DefaultFormatLtLTMedium,
	LocaleHeIL: DefaultFormatHeILMedium,
	LocaleArAE: DefaultFormatArAEMedium,
	LocaleHiIN: DefaultFormatHiINMedium,
	LocaleAzAZ: DefaultFormatAzAZMedium,
	LocaleViVN: DefaultFormatViVNMedium,
	LocaleEtEE: DefaultFormatEtEEMedium,
	LocaleHrHR: DefaultFormatHrHRMedium,
	LocaleLvLV: DefaultFormatLvLVMedium,
	LocaleSkSK: DefaultFormatSkSKMedium,
	LocaleThTH: DefaultFormatThTHMedium,
	LocaleUzUZ: DefaultFormatUzUZMedium,
	LocaleKkKZ: DefaultFormatKkKZMedium,
}

MediumFormatsByLocale maps locales to the 'medium' date formats for all supported locales.

View Source 
var ShortFormatsByLocale = map[Locale]string{
	LocaleEnUS: DefaultFormatEnUSShort,
	LocaleEnGB: DefaultFormatEnGBShort,
	LocaleDaDK: DefaultFormatDaDKShort,
	LocaleNlBE: DefaultFormatNlBEShort,
	LocaleNlNL: DefaultFormatNlNLShort,
	LocaleFiFI: DefaultFormatFiFIShort,
	LocaleFrFR: DefaultFormatFrFRShort,
	LocaleFrCA: DefaultFormatFrCAShort,
	LocaleFrLU: DefaultFormatFrLUShort,
	LocaleFrMQ: DefaultFormatFrMQShort,
	LocaleFrGF: DefaultFormatFrGFShort,
	LocaleFrGP: DefaultFormatFrGPShort,
	LocaleFrRE: DefaultFormatFrREShort,
	LocaleDeDE: DefaultFormatDeDEShort,
	LocaleHuHU: DefaultFormatHuHUShort,
	LocaleItIT: DefaultFormatItITShort,
	LocaleNnNO: DefaultFormatNnNOShort,
	LocaleNbNO: DefaultFormatNbNOShort,
	LocalePtPT: DefaultFormatPtPTShort,
	LocalePtBR: DefaultFormatPtBRShort,
	LocaleRoRO: DefaultFormatRoROShort,
	LocaleRuRU: DefaultFormatRuRUShort,
	LocaleEsES: DefaultFormatEsESShort,
	LocaleCaES: DefaultFormatCaESShort,
	LocaleSvSE: DefaultFormatSvSEShort,
	LocaleTrTR: DefaultFormatTrTRShort,
	LocaleBgBG: DefaultFormatBgBGShort,
	LocaleZhCN: DefaultFormatZhCNShort,
	LocaleZhTW: DefaultFormatZhTWShort,
	LocaleZhHK: DefaultFormatZhHKShort,
	LocaleKoKR: DefaultFormatKoKRShort,
	LocaleJaJP: DefaultFormatJaJPShort,
	LocaleElGR: DefaultFormatElGRShort,
	LocaleCsCZ: DefaultFormatCsCZShort,
	LocaleUkUA: DefaultFormatUkUAShort,
	LocaleLtLT: DefaultFormatLtLTShort,
	LocaleHeIL: DefaultFormatHeILShort,
	LocaleArAE: DefaultFormatArAEShort,
	LocaleHiIN: DefaultFormatHiINShort,
	LocaleAzAZ: DefaultFormatAzAZShort,
	LocaleViVN: DefaultFormatViVNShort,
	LocaleEtEE: DefaultFormatEtEEShort,
	LocaleHrHR: DefaultFormatHrHRShort,
	LocaleLvLV: DefaultFormatLvLVShort,
	LocaleSkSK: DefaultFormatSkSKShort,
	LocaleUzUZ: DefaultFormatUzUZShort,
	LocaleKkKZ: DefaultFormatKkKZShort,
}

ShortFormatsByLocale maps locales to the 'short' date formats for all supported locales.

View Source 
var TimeFormatsByLocale = map[Locale]string{
	LocaleEnUS: DefaultFormatEnUSTime,
	LocaleEnGB: DefaultFormatEnGBTime,
	LocaleDaDK: DefaultFormatDaDKTime,
	LocaleNlBE: DefaultFormatNlBETime,
	LocaleNlNL: DefaultFormatNlNLTime,
	LocaleFiFI: DefaultFormatFiFITime,
	LocaleFrFR: DefaultFormatFrFRTime,
	LocaleFrCA: DefaultFormatFrCATime,
	LocaleFrGP: DefaultFormatFrGPTime,
	LocaleFrLU: DefaultFormatFrLUTime,
	LocaleFrMQ: DefaultFormatFrMQTime,
	LocaleFrGF: DefaultFormatFrGFTime,
	LocaleFrRE: DefaultFormatFrRETime,
	LocaleDeDE: DefaultFormatDeDETime,
	LocaleHuHU: DefaultFormatHuHUTime,
	LocaleItIT: DefaultFormatItITTime,
	LocaleNnNO: DefaultFormatNnNOTime,
	LocaleNbNO: DefaultFormatNbNOTime,
	LocalePtPT: DefaultFormatPtPTTime,
	LocalePtBR: DefaultFormatPtBRTime,
	LocaleRoRO: DefaultFormatRoROTime,
	LocaleRuRU: DefaultFormatRuRUTime,
	LocaleEsES: DefaultFormatEsESTime,
	LocaleCaES: DefaultFormatCaESTime,
	LocaleSvSE: DefaultFormatSvSETime,
	LocaleTrTR: DefaultFormatTrTRTime,
	LocaleBgBG: DefaultFormatBgBGTime,
	LocaleZhCN: DefaultFormatZhCNTime,
	LocaleZhTW: DefaultFormatZhTWTime,
	LocaleZhHK: DefaultFormatZhHKTime,
	LocaleKoKR: DefaultFormatKoKRTime,
	LocaleJaJP: DefaultFormatJaJPTime,
	LocaleElGR: DefaultFormatElGRTime,
	LocaleCsCZ: DefaultFormatCsCZTime,
	LocaleUkUA: DefaultFormatUkUATime,
	LocaleLtLT: DefaultFormatLtLTTime,
	LocaleHeIL: DefaultFormatHeILTime,
	LocaleArAE: DefaultFormatArAETime,
	LocaleHiIN: DefaultFormatHiINTime,
	LocaleAzAZ: DefaultFormatAzAZTime,
	LocaleViVN: DefaultFormatViVNTime,
	LocaleEtEE: DefaultFormatEtEETime,
	LocaleHrHR: DefaultFormatHrHRTime,
	LocaleLvLV: DefaultFormatLvLVTime,
	LocaleSkSK: DefaultFormatSkSKTime,
	LocaleUzUZ: DefaultFormatUzUZTime,
	LocaleKkKZ: DefaultFormatKkKZTime,
}

TimeFormatsByLocale maps locales to the 'Time' date formats for all supported locales.

Functions

func Format 

func Format(dt time.Time, layout string, locale Locale) string

Format is the standard time.Format wrapper, that replaces known standard 'time' package identifiers for months and days to their equivalents in the specified language.

Values of variables 'longDayNames', 'shortDayNames', 'longMonthNames', 'shortMonthNames' from file 'time/format.go' (revision 'go1') are chosen as the 'known' words.

Some languages have specific behavior, e.g. in Russian language month names have different suffix when they are presented stand-alone (i.e. in a list or something) and yet another one when they are part of a formatted date. So, even though March is "Март" in Russian, correctly formatted today's date would be: "7 марта 2007". Thus, some transformations for some languages may be a bit more complex than just plain replacements.

Example 
t := time.Date(2013, 4, 25, 0, 0, 0, 0, time.UTC)

locales := ListLocales()
for _, loc := range locales {
	fmt.Printf("Locale: %s\n", loc)

	// Full date format
	fmt.Printf("    Full: %s\n", Format(t, FullFormatsByLocale[loc], loc))
	// Long date format
	fmt.Printf("    Long: %s\n", Format(t, LongFormatsByLocale[loc], loc))
	// Medium date format
	fmt.Printf("    Medium: %s\n", Format(t, MediumFormatsByLocale[loc], loc))
	// Short date format
	fmt.Printf("    Short: %s\n", Format(t, ShortFormatsByLocale[loc], loc))
	// DateTime format
	fmt.Printf("    DateTime: %s\n", Format(t, DateTimeFormatsByLocale[loc], loc))
}

Output:

func GetLongDays 

func GetLongDays(locale Locale) []string

GetLongDays retrieves the list of days for the given locale. It will return the full name of the days of the week.

If the locale cannot be found, the resulting slice will be nil.

func GetLongMonths 

func GetLongMonths(locale Locale) []string

GetLongMonths retrieves the list of months for the given locale. In contrast to the "short" version of this function, this functions returns the full name of the month.

If the locale cannot be found, the resulting slice will be nil.

func GetShortDays 

func GetShortDays(locale Locale) []string

GetShortDays retrieves the list of days for the given locale. "Short" days are abbreviated versions of the full day names. In English, for example, this might return "Tues" for "Tuesday". For certain locales, the long and short form of the days of the week may be the same.

If the locale cannot be found, the resulting slice will be nil.

func GetShortMonths 

func GetShortMonths(locale Locale) []string

GetShortMonths retrieves the list of months for the given locale. "Short" months are abbreviated versions of the full month names. In English, for example, this might return "Jan" for "January". For certain locales, the long and short form of the months may be the same.

If the locale cannot be found, the resulting slice will be nil.

func Parse 

func Parse(layout, value string, locale Locale) (time.Time, error)

Parse is the standard time.Parse wrapper, which replaces known month/day translations for a specified locale back to English before calling time.Parse.

Example 
layout := "2 January 2006 15:04:05 MST"

fmt.Println(Parse(layout, "12 April 2013 00:00:00 MST", LocaleEnUS))
fmt.Println(Parse(layout, "12 апреля 2013 00:00:00 MST", LocaleRuRU))
fmt.Println(Parse(layout, "12 квітня 2013 00:00:00 MST", LocaleUkUA))

Output:

func ParseInLocation 

func ParseInLocation(layout, value string, loc *time.Location, locale Locale) (time.Time, error)

ParseInLocation is the standard time.ParseInLocation wrapper, which replaces known month/day translations for a specified locale back to English before calling time.ParseInLocation. So, you can parse localized dates with this wrapper.

Example 
layout := "2 January 2006 15:04:05 MST"

fmt.Println(ParseInLocation(layout, "12 April 2013 00:00:00 MST", time.UTC, LocaleEnUS))
fmt.Println(ParseInLocation(layout, "12 апреля 2013 00:00:00 MST", time.UTC, LocaleRuRU))
fmt.Println(ParseInLocation(layout, "12 квітня 2013 00:00:00 MST", time.UTC, LocaleUkUA))

Output:

Types

type InvalidLengthError 

type InvalidLengthError struct {
	// contains filtered or unexported fields
}

An InvalidLengthError is returned when an item's length was longer or shorter than expected for a particular token.

func NewInvalidLengthError 

func NewInvalidLengthError() InvalidLengthError

NewInvalidLengthError instantiates an InvalidLengthError.

type InvalidTypeError 

type InvalidTypeError struct {
	// contains filtered or unexported fields
}

An InvalidTypeError indicates that data was parsed incorrectly as a result of a type mismatch.

func NewInvalidTypeError 

func NewInvalidTypeError() InvalidTypeError

NewInvalidTypeError instantiates an InvalidTypeError.

type Locale 

type Locale string

Locale identifies locales supported by 'monday' package. Monday uses ICU locale identifiers. See http://userguide.icu-project.org/locale

func ListLocales 

func ListLocales() []Locale

ListLocales returns all locales supported by the package.

type LocaleDetector 

type LocaleDetector struct {
	// contains filtered or unexported fields
}

A LocaleDetector parses time.Time values by using various heuristics and techniques to determine which locale should be used to parse the time.Time value. As not all possible locales and formats are supported, this process can be somewhat lossy and inaccurate.

func NewLocaleDetector 

func NewLocaleDetector() *LocaleDetector

NewLocaleDetector instances a LocaleDetector instance.

func (*LocaleDetector) Parse 

func (ld *LocaleDetector) Parse(layout, value string) (time.Time, error)

Parse will attempt to parse a time.Time struct from a layout (format) and a value to parse from.

If no locale can be determined, this method will return an error and an empty time object.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.