org.apache.poi.util

Class LocaleUtil

java.lang.Object

org.apache.poi.util.LocaleUtil

public final class LocaleUtil
extends java.lang.Object

This utility class is used to set locale and time zone settings beside of the JDK internal Locale.setDefault(Locale) and TimeZone.setDefault(TimeZone) methods, because the locale/time zone specific handling of certain office documents - maybe for different time zones / locales ... - shouldn't affect other java components. The settings are saved in a ThreadLocal, so they only apply to the current thread and can't be set globally. (此实用程序类用于在 JDK 内部 Locale.setDefault(Locale) 和 TimeZone.setDefault(TimeZone) 方法之外设置区域设置和时区设置，因为特定办公文档的区域设置/时区特定处理 - 可能针对不同的时区/locales ... - 不应影响其他 java 组件。设置保存在 ThreadLocal 中，因此它们仅适用于当前线程，不能全局设置。)

Field Summary

Fields

Modifier and Type	Field and Description
static java.nio.charset.Charset	CHARSET_1252 Default encoding for unknown byte encodings of native files (at least it's better than to rely on a platform dependent encoding for legacy stuff ...) (本机文件的未知字节编码的默认编码（至少它比依赖于平台相关的遗留编码更好......）)
static java.util.TimeZone	TIMEZONE_UTC Excel doesn't store TimeZone information in the file, so if in doubt, use UTC to perform calculations (Excel 不会在文件中存储时区信息，因此如果有疑问，请使用 UTC 执行计算)

Method Summary

Modifier and Type	Method and Description
static int	getDefaultCodePageFromLCID(int lcid) Get default code page from LCID value (从 LCID 值获取默认代码页)
static java.util.Calendar	getLocaleCalendar()
static java.util.Calendar	getLocaleCalendar(int year, int month, int day) Convenience method - month is 0-based as in java.util.Calendar (方便的方法 - 月份是基于 0 的，如 java.util.Calendar)
static java.util.Calendar	getLocaleCalendar(int year, int month, int day, int hour, int minute, int second) Convenience method - month is 0-based as in java.util.Calendar (方便的方法 - 月份是基于 0 的，如 java.util.Calendar)
static java.util.Calendar	getLocaleCalendar(java.util.TimeZone timeZone)
static java.lang.String	getLocaleFromLCID(int lcid) Decode the language ID from LCID value (从 LCID 值解码语言 ID)
static java.util.Locale	getUserLocale()
static java.util.TimeZone	getUserTimeZone()
static void	resetUserLocale()
static void	resetUserTimeZone() Clear the thread-local user time zone. (清除线程本地用户时区。)
static void	setUserLocale(java.util.Locale locale) Sets default user locale. (设置默认用户区域设置。)
static void	setUserTimeZone(java.util.TimeZone timezone) As time zone information is not stored in any format, it can be set before any date calculations take place. (由于时区信息不以任何格式存储，因此可以在进行任何日期计算之前进行设置。)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

TIMEZONE_UTC

public static final java.util.TimeZone TIMEZONE_UTC

Excel doesn't store TimeZone information in the file, so if in doubt, use UTC to perform calculations (Excel 不会在文件中存储时区信息，因此如果有疑问，请使用 UTC 执行计算)

CHARSET_1252

public static final java.nio.charset.Charset CHARSET_1252

Default encoding for unknown byte encodings of native files (at least it's better than to rely on a platform dependent encoding for legacy stuff ...) (本机文件的未知字节编码的默认编码（至少它比依赖于平台相关的遗留编码更好......）)

Method Detail

setUserTimeZone

public static void setUserTimeZone(java.util.TimeZone timezone)

As time zone information is not stored in any format, it can be set before any date calculations take place. This setting is specific to the current thread. (由于时区信息不以任何格式存储，因此可以在进行任何日期计算之前进行设置。此设置特定于当前线程。)

Parameters:

timezone - the timezone under which date calculations take place (timezone - 进行日期计算的时区)

getUserTimeZone

public static java.util.TimeZone getUserTimeZone()

Returns:

the time zone which is used for date calculations. If not set, returns TimeZone.getDefault(). (用于日期计算的时区。如果未设置，则返回 TimeZone.getDefault()。)

resetUserTimeZone

public static void resetUserTimeZone()

Clear the thread-local user time zone. (清除线程本地用户时区。)

setUserLocale

public static void setUserLocale(java.util.Locale locale)

Sets default user locale. This setting is specific to the current thread. (设置默认用户区域设置。此设置特定于当前线程。)

getUserLocale

public static java.util.Locale getUserLocale()

Returns:

the default user locale. If not set, returns Locale.getDefault(). (默认用户语言环境。如果未设置，则返回 Locale.getDefault()。)

resetUserLocale

public static void resetUserLocale()

getLocaleCalendar

public static java.util.Calendar getLocaleCalendar()

Returns:

a calendar for the user locale and time zone (用户区域设置和时区的日历)

getLocaleCalendar

public static java.util.Calendar getLocaleCalendar(int year,
                                                   int month,
                                                   int day)

Convenience method - month is 0-based as in java.util.Calendar (方便的方法 - 月份是基于 0 的，如 java.util.Calendar)

Parameters:

year - (年 -)

month - (月 -)

day - (日 -)

Returns:

a calendar for the user locale and time zone, and the given date (用户区域设置和时区的日历，以及给定的日期)

getLocaleCalendar

public static java.util.Calendar getLocaleCalendar(int year,
                                                   int month,
                                                   int day,
                                                   int hour,
                                                   int minute,
                                                   int second)

Convenience method - month is 0-based as in java.util.Calendar (方便的方法 - 月份是基于 0 的，如 java.util.Calendar)

Parameters:

year - (年 -)

month - (月 -)

day - (日 -)

hour - (小时 -)

minute - (分钟 -)

second - (第二 -)

Returns:

a calendar for the user locale and time zone, and the given date (用户区域设置和时区的日历，以及给定的日期)

getLocaleCalendar

public static java.util.Calendar getLocaleCalendar(java.util.TimeZone timeZone)

Returns:

a calendar for the user locale and time zone (用户区域设置和时区的日历)

getLocaleFromLCID

public static java.lang.String getLocaleFromLCID(int lcid)

Decode the language ID from LCID value (从 LCID 值解码语言 ID)

Parameters:

lcid - the LCID value (lcid - LCID 值)

Returns:

the locale/language ID (语言环境/语言 ID)

getDefaultCodePageFromLCID

public static int getDefaultCodePageFromLCID(int lcid)

Get default code page from LCID value (从 LCID 值获取默认代码页)

Parameters:

lcid - the LCID value (lcid - LCID 值)

Returns:

the default code page (默认代码页)