Get-Culture
Obtém a cultura atual definida no sistema operacional.
Syntax
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 de interface do usuário atual 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
Sunday
Este 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 . Esse 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 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 compatíveis com o sistema operacional atual.
Esse parâmetro foi introduzido no PowerShell 6.2.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Recupere uma cultura específica com base no nome.
Esse parâmetro foi introduzido no PowerShell 6.2.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoUserOverrides
Ignorar as alterações do usuário para a cultura atual.
Esse parâmetro foi introduzido no PowerShell 6.2.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Você não pode canalizar objetos para este 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 de interface do usuário atual.