Partilhar via


Get-Culture

Obtém a cultura atual definida no sistema operacional.

Sintaxe

Get-Culture
   [-NoUserOverrides]
   [<CommonParameters>]
Get-Culture
   [-Name <String[]>]
   [-NoUserOverrides]
   [<CommonParameters>]
Get-Culture
   [-ListAvailable]
   [<CommonParameters>]

Description

O Get-Culture cmdlet obtém informações sobre as configurações de cultura atuais. Isso inclui informações sobre as configurações de idioma atuais no sistema, como o layout do teclado e o formato de exibição de itens como números, moeda e datas.

Você também pode usar o Get-UICulture cmdlet, que obtém a cultura atual da interface do usuário no sistema, e o cmdlet Set-Culture no módulo Internacional. A cultura da interface do usuário (UI) determina quais cadeias de texto são usadas para elementos da interface do usuário, como menus e mensagens.

Exemplos

Exemplo 1: Obter configurações de cultura

Get-Culture

LCID             Name             DisplayName
----             ----             -----------
1033             en-US            English (United States)

Este comando exibe informações sobre as configurações regionais no computador.

Exemplo 2: Formatar as propriedades de um objeto de cultura

PS C:\> $C = Get-Culture
PS C:\> $C | Format-List -Property *
Parent                         : en
LCID                           : 1033
KeyboardLayoutId               : 1033
Name                           : en-US
IetfLanguageTag                : en-US
DisplayName                    : English (United States)
NativeName                     : English (United States)
EnglishName                    : English (United States)
TwoLetterISOLanguageName       : en
ThreeLetterISOLanguageName     : eng
ThreeLetterWindowsLanguageName : ENU
CompareInfo                    : CompareInfo - 1033
TextInfo                       : TextInfo - 1033
IsNeutralCulture               : False
CultureTypes                   : SpecificCultures, InstalledWin32Cultures, FrameworkCultures
NumberFormat                   : System.Globalization.NumberFormatInfo
DateTimeFormat                 : System.Globalization.DateTimeFormatInfo
Calendar                       : System.Globalization.GregorianCalendar
OptionalCalendars              : {System.Globalization.GregorianCalendar, System.Globalization.GregorianCalendar}
UseUserOverride                : True
IsReadOnly                     : False

PS C:\> $C.Calendar
MinSupportedDateTime : 1/1/0001 12:00:00 AM
MaxSupportedDateTime : 12/31/9999 11:59:59 PM
AlgorithmType        : SolarCalendar
CalendarType         : Localized
Eras                 : {1}
TwoDigitYearMax      : 2029
IsReadOnly           : False

PS C:\> $C.DateTimeFormat
AMDesignator                     : AM
Calendar                         : System.Globalization.GregorianCalendar
DateSeparator                    : /
FirstDayOfWeek                   : Sunday
CalendarWeekRule                 : FirstDay
FullDateTimePattern              : dddd, MMMM dd, yyyy h:mm:ss tt
LongDatePattern                  : dddd, MMMM dd, yyyy
LongTimePattern                  : h:mm:ss tt
MonthDayPattern                  : MMMM dd
PMDesignator                     : PM
RFC1123Pattern                   : ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
ShortDatePattern                 : M/d/yyyy
ShortTimePattern                 : h:mm tt
SortableDateTimePattern          : yyyy'-'MM'-'dd'T'HH':'mm':'ss
TimeSeparator                    : :
UniversalSortableDateTimePattern : yyyy'-'MM'-'dd HH':'mm':'ss'Z'
YearMonthPattern                 : MMMM, yyyy
AbbreviatedDayNames              : {Sun, Mon, Tue, Wed...}
ShortestDayNames                 : {Su, Mo, Tu, We...}
DayNames                         : {Sunday, Monday, Tuesday, Wednesday...}
AbbreviatedMonthNames            : {Jan, Feb, Mar, Apr...}
MonthNames                       : {January, February, March, April...}
IsReadOnly                       : False
NativeCalendarName               : Gregorian Calendar
AbbreviatedMonthGenitiveNames    : {Jan, Feb, Mar, Apr...}
MonthGenitiveNames               : {January, February, March, April...}

PS C:\> $C.DateTimeFormat.FirstDayOfWeek
Sunday

Este exemplo demonstra a grande quantidade de dados no objeto culture. Ele mostra como exibir as propriedades e subpropriedades do objeto.

O primeiro comando usa o Get-Culture cmdlet para obter as configurações de cultura atuais no computador. Ele armazena o objeto de cultura resultante na $C variável.

O segundo comando exibe todas as propriedades do objeto culture. Ele usa um operador de pipeline (|) para enviar o objeto $C de cultura para o Format-List cmdlet. Ele usa o parâmetro Property para exibir todas as propriedades (*) do objeto. Este comando pode ser abreviado como $c | fl *.

Os comandos restantes exploram as propriedades do objeto culture usando notação de ponto para exibir os valores das propriedades do objeto. Você pode usar essa notação para exibir o valor de qualquer propriedade do objeto.

O terceiro comando usa notação de ponto para exibir o valor da propriedade Calendar do objeto culture.

O quarto comando usa notação de ponto para exibir o valor da propriedade DataTimeFormat do objeto culture.

Muitas propriedades de objeto têm propriedades. O quinto comando usa notação de ponto para exibir o valor da propriedade FirstDayOfWeek da propriedade DateTimeFormat .

Exemplo 3: Obter uma cultura específica

Obtenha o objeto CultureInfo para francês na França.

Get-Culture -Name fr-FR

LCID             Name             DisplayName
----             ----             -----------
1036             fr-FR            French (France)

Parâmetros

-ListAvailable

Recupera todas as culturas suportadas pelo sistema operacional atual.

Esse parâmetro foi introduzido no PowerShell 6.2.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Recupere uma cultura específica com base no nome.

Esse parâmetro foi introduzido no PowerShell 6.2.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-NoUserOverrides

Ignore as alterações do usuário para a cultura atual.

Esse parâmetro foi introduzido no PowerShell 6.2.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Não é possível canalizar objetos para este cmdlet.

Saídas

CultureInfo

Este cmdlet retorna um objeto CultureInfo que representa a cultura atual.

Notas

Você também pode usar as $PsCulture variáveis e $PsUICulture . A $PsCulture variável armazena o nome da cultura atual e a variável armazena $PsUICulture o nome da cultura da interface do usuário atual.