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
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.