Number Format Codes/text/shared/01/05020301.xhpformat codes; numbersconditions; in number formatsnumber formats; codescurrency formatsformats;of currencies/date/timenumbers; date, time and currency formatsEuro; currency formatsdate formatstimes, formatsmw made "time formats" a two level entry and deleted 2x "formats;"Number Format Codes
Number format codes can consist of up to three sections separated by a semicolon (;).In a number format code with two sections, the first section applies to positive values and zero, and the second section applies to negative values.In a number format code with three sections, the first section applies to positive values, the second section to negative values, and the third section to the value zero.You can also assign conditions to the three sections, so that the format is only applied if a condition is met.Decimal Places and Significant DigitsUse zero (0) or the number sign (#) as placeholders in your number format code to represent numbers. The (#) only displays significant digits, while the (0) displays zeroes if there are fewer digits in the number than in the number format.Use question marks (?) to represent the number of digits to include in the numerator and the denominator of a fraction. Fractions that do not fit the pattern that you define are displayed as floating point numbers.If a number contains more digits to the right of the decimal delimiter than there are placeholders in the format, the number is rounded accordingly. If a number contains more digits to the left of the decimal delimiter than there are placeholders in the format, the entire number is displayed. Use the following list as a guide for using placeholders when you create a number format code:
PlaceholdersExplanation#Does not display extra zeros.0 (Zero)Displays extra zeros if the number has less places than zeros in the format.
Examples
Number FormatFormat Code3456.78 as 3456.8####.#9.9 as 9.900#.00013 as 13.0 and 1234.567 as 1234.57#.0#5.75 as 5 3/4 and 6.3 as 6 3/10# ???/???.5 as 0.50.##
Thousands SeparatorDepending on your language setting, you can use a comma or a period as a thousands separator. You can also use the separator to reduce the size of the number that is displayed by a multiple of 1000.
Number FormatFormat Code15000 as 15,000#,###16000 as 16#,
Including Text in Number Format CodesText and NumbersTo include text in a number format that is applied to a cell containing numbers, place a double quotation mark (") in front of and behind the text, or a backslash (\) before a single character. For example, enter #.# "meters" to display "3.5 meters" or #.# \m to display "3.5 m".Text and TextTo include text in a number format that is applied to a cell that might contain text, enclose the text by double quotation marks (" "), and then add an at sign (@). For example, enter "Total for "@ to display "Total for December".SpacesTo use a character to define the width of a space in a number format, type an underscore ( _ ) followed by the character. The width of the space varies according to the width of the character that you choose. For example, _M creates a wider space than _i.ColorTo set the color of a section of a number format code, insert one of the following color names in square brackets [ ]:
CYANGREENBLACKBLUEMAGENTAREDWHITEYELLOW
ConditionsConditional BracketsYou can define a number format so that it only applies when the condition that you specify is met. Conditions are enclosed by square brackets [ ].You can use any combination of numbers and the <, <=, >, >=, = and <> operators.For example, if you want to apply different colors to different temperature data, enter:[BLUE][<0]#,0 "°C";[RED][>30]#,0 "°C";[BLACK]#,0 "°C"All temperatures below zero are blue, temperatures between 0 and 30 °C are black, and temperatures higher than 30 °C are red.Positive and Negative NumbersTo define a number format that adds a different text to a number depending on if the number is positive, negative, or equal to zero, use the following format:"plus" 0;"minus" 0;"null" 0Percentages and Scientific NotationPercentagesTo display numbers as percentages, add the percent sign (%) to the number format.Scientific NotationScientific notation lets you write very large numbers or very small fractions in a compact form. For example, in scientific notation, 650000 is written as 6.5 x 10^5, and 0.000065 as 6.5 x 10^-5. Translators: use the decimal delimiter of your language (period or comma) for all number format codes in Calc.In %PRODUCTNAME, these numbers are written as 6.5E+5 and 6.5E-5, respectively. To create a number format that displays numbers using scientific notation, enter a # or 0, and then one of the following codes E-, E+, e- or e+.Number Format Codes of Currency FormatsThe default currency format for the cells in your spreadsheet is determined by the regional setting of your operating system. If you want, you can apply a custom currency symbol to a cell. For example, enter #,##0.00 € to display 4.50 € (Euros).Translators: use the decimal delimiter of your language (period or comma) for all number format codes in Calc.You can also specify the locale setting for the currency by entering the locale code for the country after the symbol. For example, [$€-407] represents Euros in Germany. To view the locale code for a country, select the country in the Language list on the Numbers tab of the Format Cells dialog.Date and Time FormatsDate FormatsTo display days, months and years, use the following number format codes.Not all format codes give meaningful results for all languages.
FormatFormat CodeMonth as 3.MMonth as 03.MMMonth as Jan-DecMMMMonth as January-DecemberMMMMFirst letter of Name of MonthMMMMMDay as 2DDay as 02DDDay as Sun-SatNN or DDDDay as Sunday to SaturdayNNN or DDDDDay followed by comma, as in "Sunday,"NNNNYear as 00-99YYYear as 1900-2078YYYYCalendar weekWWQuarterly as Q1 to Q4QQuarterly as 1st quarter to 4th quarterQQEra on the Japanese Gengou calendar, single character (possible values are: M, T, S, H)GEra, abbreviationGGEra, full nameGGGNumber of the year within an era, without a leading zero for single-digit yearsENumber of the year within an era, with a leading zero for single-digit yearsEE or REra, full name and yearRR or GGGEE
The above listed formatting codes work with your language version of %PRODUCTNAME. However, when you need to switch the locale of %PRODUCTNAME to another locale, you will need to know the formatting codes used in that other locale.For example, if your software is set to an English locale, and you want to format a year with four digits, you enter YYYY as a formatting code. When you switch to a German locale, you must use JJJJ instead. The following table lists only the localized differences.
LocaleYearMonthDayHourDay Of WeekEraEnglish - enand all not listed localesYMDHAGGerman - deJTNetherlands - nlJUFrench - frAJOItalian - itAGOXPortuguese - ptAOSpanish - esAODanish - daTNorwegian - no, nb, nnTSwedish - svTFinnish - fiVKPT
Entering DatesTo enter a date in a cell, use the Gregorian calendar format. For example, in an English locale, enter 1/2/2002 for Jan 2, 2002.All date formats are dependent on the locale that is set in %PRODUCTNAME - PreferencesTools - Options - Language settings - Languages. For example, if your locale is set to 'Japanese', then the Gengou calendar is used. The default date format in %PRODUCTNAME uses the Gregorian Calendar.To specify a calendar format that is independent of the locale, add a modifier in front of the date format. For example, to display a date using the Jewish calendar format in a non-Hebrew locale, enter: [~jewish]DD/MM/YYYY.
ModifierCalendar[~buddhist]Thai Buddhist Calendar[~gengou]Japanese Gengou Calendar[~gregorian]Gregorian Calendar[~hanja] or [~hanja_yoil]Korean Calendar[~hijri]Arabic Islamic Calendar, currently supported for the following locales: ar_EG, ar_LB, ar_SA, and ar_TN[~jewish]Jewish Calendar[~ROC]Republic Of China Calendar
If you perform a calculation that involves one or more cells using a date format, the result is formatted according to the following mappings:
The Date&Time format displays the date and time that an entry was made to a cell with this format.In %PRODUCTNAME, a date with the value "0" corresponds to Dec 30, 1899.Time FormatsTo display hours, minutes and seconds use the following number format codes.
FormatFormat CodeHours as 0-23hHours as 00-23hhMinutes as 0-59mMinutes as 00-59mmSeconds as 0-59sSeconds as 00-59ss
To display seconds as fractions, add the decimal delimiter to your number format code. For example, enter hh:mm:ss.00 to display the time as "01:02:03.45".Translators: use the decimal delimiter of your language (period or comma) for all number format codes in Calc.If a time is entered in the form 02:03.45 or 01:02:03.45 or 25:01:02, the following formats are assigned if no other time format has been specified: MM:SS.00 or [HH]:MM:SS.00 or [HH]:MM:SSTranslators: use the decimal delimiter of your language (period or comma) for all number format codes in Calc.Displaying Numbers Using Native CharactersTo display numbers using native number characters, use a [NatNum1], [NatNum2], ... [NatNum11] modifier at the beginning of a number format codes.The [NatNum1] modifier always uses a one to one character mapping to convert numbers to a string that matches the native number format code of the corresponding locale. The other modifiers produce different results if they are used with different locales. A locale can be the language and the territory for which the format code is defined, or a modifier such as [$-yyy] that follows the native number modifier. In this case, yyy is the hexadecimal MS-LCID that is also used in currency format codes. For example, to display a number using Japanese short Kanji characters in an English US locale, use the following number format code:[NatNum1][$-411]0In the following list, the Microsoft Excel [DBNumX] modifier that corresponds to %PRODUCTNAME [NatNum] modifier is shown. If you want, you can use a [DBNumX] modifier instead of [NatNum] modifier for your locale. Whenever possible, %PRODUCTNAME internally maps [DBNumX] modifiers to [NatNumN] modifiers.Displaying dates using [NatNum] modifiers can have a different effect than displaying other types of numbers. Such effects are indicated by 'CAL: '. For example, 'CAL: 1/4/4' indicates that the year is displayed using the [NatNum1] modifier, while the day and month are displayed using the [NatNum4] modifier. If 'CAL' is not specified, the date formats for that particular modifier are not supported.[NatNum1] Transliterations
Chinese: Chinese lower case characters; CAL: 1/7/7 [DBNum1]Japanese: short Kanji characters [DBNum1]; CAL: 1/4/4 [DBNum1]Korean: Korean lower case characters [DBNum1]; CAL: 1/7/7 [DBNum1]Thai: Thai charactersArabic: Indic charactersIndic: Indic charactersHebrew: Hebrew lettersUFI: api-features "Hebrew numbering"[NatNum2] Transliteration inChinese: Chinese upper case characters; CAL: 2/8/8 [DBNum2]Japanese: traditional Kanji characters; CAL: 2/5/5 [DBNum2]Korean: Korean upper case characters [DBNum2]; CAL: 2/8/8 [DBNum2][NatNum3] Transliteration inChinese: fullwidth Arabic digits; CAL: 3/3/3 [DBNum3]Japanese: fullwidth Arabic digits; CAL: 3/3/3 [DBNum3]Korean: fullwidth Arabic digits [DBNum3]; CAL: 3/3/3 [DBNum3][NatNum4] Transliteration inChinese: lower case text [DBNum1]Japanese: modern long Kanji text [DBNum2]Korean: formal lower case text[NatNum5] Transliteration inChinese: Chinese upper case text [DBNum2]Japanese: traditional long Kanji text [DBNum3]Korean: formal upper case text[NatNum6] Transliteration inChinese: fullwidth text [DBNum3]Japanese: fullwidth textKorean: fullwidth text[NatNum7] Transliteration inJapanese: modern short Kanji textKorean: informal lower case text[NatNum8] Transliteration inJapanese: traditional short Kanji text [DBNum4]Korean: informal upper case text[NatNum9] Transliteration inKorean: Hangul characters[NatNum10] Transliteration inKorean: formal Hangul text [DBNum4]; CAL: 9/11/11 [DBNum4][NatNum11] Transliteration inKorean: informal Hangul text