Get-Culture
Obtém o conjunto de cultura atual no sistema operacional.
Sintaxe
CurrentCulture (Padrão)
Get-Culture
[-NoUserOverrides]
[<CommonParameters>]
Name
Get-Culture
[-Name <String[]>]
[-NoUserOverrides]
[<CommonParameters>]
ListAvailable
Get-Culture
[-ListAvailable]
[<CommonParameters>]
Description
O cmdlet Get-Culture 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 cmdlet Get-UICulture, que obtém a cultura de interface do usuário atual no sistema e o cmdlet Set-Culture no módulo Internacional.
A cultura da interface do usuário (interface do usuário) determina quais cadeias de caracteres de texto sã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)
Esse 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 de cultura. Ele mostra como exibir as propriedades e as sub-propriedades do objeto.
O primeiro comando usa o cmdlet Get-Culture para obter as configurações de cultura atuais no computador.
Ele armazena o objeto de cultura resultante na variável $C.
O segundo comando exibe todas as propriedades do objeto de cultura. Ele usa um operador de pipeline (|) para enviar o objeto de cultura em $C para o cmdlet Format-List. Ele usa o parâmetro Property para exibir todas as propriedades (*) do objeto. Esse comando pode ser abreviado como $c | fl *.
Os comandos restantes exploram as propriedades do objeto de cultura 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 de cultura.
O quarto comando usa 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 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 compatíveis com o sistema operacional atual.
Esse parâmetro foi introduzido no PowerShell 6.2.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ListAvailable
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Recupere uma cultura específica com base no nome.
Esse parâmetro foi introduzido no PowerShell 6.2.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Name
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-NoUserOverrides
Ignorar as alterações do usuário para a cultura atual.
Esse parâmetro foi introduzido no PowerShell 6.2.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
CurrentCulture
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Name
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
None
Não é possível transferir objetos para esse cmdlet.
Saídas
CultureInfo
Esse cmdlet retorna um objeto CultureInfo que representa a cultura atual.
Observações
Você também pode usar as variáveis $PSCulture e $PSUICulture. A variável $PSCulture armazena o nome da cultura atual e a variável $PSUICulture armazena o nome da cultura da interface do usuário atual.