Functions/Format-TitleCase.ps1
|
function Format-TitleCase { <# .SYNOPSIS Get the last day of the month given the year as an integer, and the month as an integer .DESCRIPTION Get the last day of the month given the year as an integer, and the month as an integer .PARAMETER String String or string array that you want to be put into your cultures title case .PARAMETER ToLowerFirst Switch to first put the string to lower case then put to title case .PARAMETER IncludeInput Switch to include the input in the output .EXAMPLE Format-TitleCase -String 'hello THERE' Hello THERE .EXAMPLE Format-TitleCase -String 'hello THERE' -ToLowerFirst Hello There .EXAMPLE Format-TitleCase -String 'hello THERE' -ToLowerFirst -IncludeInput Original ToLowerFirst TitleCase -------- ------------ --------- hello THERE True Hello There .NOTES Inspired by: https://community.idera.com/database-tools/powershell/powertips/b/tips/posts/title-casing-strings-capital-letter-starts-each-word #> [cmdletbinding()] [OutputType('string')] param( [parameter(Mandatory, HelpMessage = 'Please enter a string that you want to put in Title Case', ValueFromPipeline, ValueFromPipelineByPropertyName)] [string[]] $String, [switch] $ToLowerFirst, [switch] $IncludeInput ) begin { Write-Verbose -Message "Starting [$($MyInvocation.Mycommand)]" $TextInfo = (Get-Culture).TextInfo } process { foreach ($curString in $String) { if ($ToLowerFirst) { $ReturnVal = $TextInfo.ToTitleCase($curString.ToLower()) } else { $ReturnVal = $TextInfo.ToTitleCase($curString) } if ($IncludeInput) { New-Object -TypeName psobject -Property ([ordered] @{ Original = $curString ToLowerFirst = $ToLowerFirst TitleCase = $ReturnVal }) } else { Write-Output -InputObject $ReturnVal } } } end { Write-Verbose -Message "Ending [$($MyInvocation.Mycommand)]" } } |