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 determina quais cadeias de caracteres de texto serão usadas para elementos de 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 do 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
SundayEste exemplo demonstra a enorme quantidade de dados do objeto de cultura. 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 de cultura. 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 cultura usando a 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 a notação de ponto para exibir o valor da propriedade Calendar do objeto de cultura.
O quarto comando usa a notação de ponto para exibir o valor da propriedade DataTimeFormat do objeto de cultura.
Muitas propriedades de objeto têm propriedades. O quinto comando usa a 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 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
Recupere uma cultura específica com base no nome.
Esse parâmetro foi introduzido no PowerShell 6.2.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-NoUserOverrides
Ignore as alterações do usuário para a cultura atual.
Esse parâmetro foi introduzido no PowerShell 6.2.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
None
Você não pode canalizar objetos para esse cmdlet.
Saídas
Esse cmdlet retorna um objeto CultureInfo que representa a cultura atual.
Observações
Você também pode usar as $PsCulture variáveis e $PsUICulture . A $PsCulture variável armazena o nome da cultura atual e a $PsUICulture variável armazena o nome da cultura da interface do usuário atual.
