PowerShell/docs/list-exchange-rates.md
2024-03-27 17:36:59 +01:00

99 lines
2.8 KiB
Markdown

Script: *list-exchange-rates.ps1*
========================
This PowerShell script lists the current exchange rates for the given currency (USD per default).
Parameters
----------
```powershell
PS> ./list-exchange-rates.ps1 [[-currency] <String>] [<CommonParameters>]
-currency <String>
Specifies the base currency
Required? false
Position? 1
Default value USD
Accept pipeline input? false
Accept wildcard characters? false
[<CommonParameters>]
This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction,
WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
```
Example
-------
```powershell
PS> ./list-exchange-rates.ps1 EUR
Current Exchange Rates for 1 EUR (source: http://www.floatrates.com)
================================
Rate Currency Inverse Date
---- -------- ------- ----
1.09489154 USD - U.S. Dollar 0.91333248 Sun, 6 Aug 2023 11:55:02 GMT
...
```
Notes
-----
Author: Markus Fleschutz | License: CC0
Related Links
-------------
https://github.com/fleschutz/PowerShell
Script Content
--------------
```powershell
<#
.SYNOPSIS
Lists the exchange rates for a currency
.DESCRIPTION
This PowerShell script lists the current exchange rates for the given currency (USD per default).
.PARAMETER currency
Specifies the base currency
.EXAMPLE
PS> ./list-exchange-rates.ps1 EUR
Current Exchange Rates for 1 EUR (source: http://www.floatrates.com)
================================
Rate Currency Inverse Date
---- -------- ------- ----
1.09489154 USD - U.S. Dollar 0.91333248 Sun, 6 Aug 2023 11:55:02 GMT
...
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
param([string]$currency = "USD")
function ListExchangeRates { param([string]$currency)
[xml]$ExchangeRates = (invoke-webRequest -uri "http://www.floatrates.com/daily/$($currency).xml" -userAgent "curl" -useBasicParsing).Content
foreach($Row in $ExchangeRates.channel.item) {
new-object PSObject -property @{ 'Rate' = "$($Row.exchangeRate)"; 'Currency' = "$($Row.targetCurrency) - $($Row.targetName)"; 'Inverse' = "$($Row.inverseRate)"; 'Date' = "$($Row.pubDate)" }
}
}
try {
""
"Current Exchange Rates for 1 $currency (source: http://www.floatrates.com)"
"================================"
ListExchangeRates $currency | format-table -property Rate,Currency,Inverse,Date
exit 0 # success
} catch {
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
exit 1
}
```
*(generated by convert-ps2md.ps1 using the comment-based help of list-exchange-rates.ps1 as of 03/27/2024 17:36:28)*