STOXR-货币转换软件-开放汇率API
从Svendsen Tech PowerShell Wiki
跳到:导航, 搜索

斯托克斯 是Svendsen Tech公开汇率的缩写。它是极其自动化的货币转换软件/共享软件,具有免费试用版,可访问Open Exchange Rates API,并提供高度灵活的货币转换功能,包括货币的模糊匹配。它主要是供开发人员以当前形式使用。它是从命令行使用的,而不是图形用户界面。它是用.NET / PowerShell编写的。

该软件使用Open Exchange Rates API,并且完全依赖于此来获取数据。注册API密钥/应用程序ID时,您将与他们输入单独的合同。只需不到两分钟的时间,到2020年2月,该服务已经存在了大约十年,而且他们从未发送过垃圾邮件或广告。在这个近十年的过程中,我只收到了两封关于相关服务中断的邮件。

开放汇率 有一个免费计划,可以免费或无限期地用于测试,您可以注册该计划这里。注册仅需一分钟,作为我自己使用该服务已有多年的经验,我可以说我从未收到他们的一封垃圾邮件,出于我的目的,该服务非常可靠。

我的软件完全取决于Open Exchange Rates Web API的访问权限。初始检索时,它会在本地缓存数据,默认为30分钟。时间间隔在首次运行时设置为默认值60秒* 30(30分钟),并存储在磁盘上。

您可以使用以下功能查看和更改此值(以秒为单位)Get-STOXRCacheInterval设置STOXRCacheInterval.

如果您打算大量使用此API,并且希望它们的服务继续存在(建议支持),并且还希望遵守其条款(如果您想要更快的更新,更短的缓存时间等),那么我建议您购买带有开放汇率的计划。

注意!您需要知道如何启动powershell.exe或powershell_ise.exe,并且最好了解一些有关如何使用PowerShell的知识,以便以当前形式使用该软件。例如如何安装模块(将其放入$ Env:PSModulePath中)并运行功能。

它主要是为希望节省时间的开发人员编写的,而该开发人员可能希望节省时间,并且可能不具备执行此操作所需的技能。

内容


鸣叫

首轮

这是首次运行该软件并安装免费的Open Exchange Rates应用程序ID(获取它的示例)这里 -无垃圾邮件),然后成功地从USD转换为NOK。

STOXR试用版示例首先运行安装-打开交换率-应用程序ID-转换-currency.png

与文字相同:

PS C:\> Import-Module STOXR
警告:这是产品的试用版。您只能在两种货币之间进行切换。货币默认为“ USD”。在试用版软件中,可以每12小时更改一次。更改为带有Set-STOXRTrialCurrency -Currency GBP的英镑。要显示当前设置的试用币种,请使用Get-STOXRTrialCurrency。要列出所有受支持的货币,请使用Get-STOXRCurrencyList。
警告:尚未设置公开汇率应用ID。您需要对其进行设置才能使用此软件。可以从/获得。使用Set-STOXRAppID进行设置。
警告:在使用此软件之前,您需要使用Set-STOXRAppID设置“开放汇率”应用程序ID。

PS C:\> Set-STOXRAppID -AppID "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

PS C:\> Convert-STOXRCurrency -Amount 1 -FromCurrency USD -ToCurrency NOK


发件人金额 : 1.0000
FromAmountNumerical : 1
来自货币 : 美元
FromCurrencyText : 美国美元
金额 : 7.8185
到数值 : 7.818513
货币兑换 :挪威克朗
ToCurrencyText :挪威克朗
FromCurrencyPerUSD : 1.0000
美元兑货币 : 7.8185
日期 : 2017-09-26 03:49:05
精确 : 4

使用范例

PS C:\> Get-STOXRCurrencyList | Select-Object -First 15 |
foreach {
    $Result = Convert-STOXRCurrency 1 $_.Name USD -Precision 3
    “ 1.000 $($ _。Name)($($ _。Description))是$($ Result.ToAmount)美元”
}
1.000 AED(阿联酋迪拉姆)是0.272美元
1.000 AFN(阿富汗阿富汗尼)是0.015美元
1.000 ALL(Albanian Lek)是0.009美元
1.000 AMD(亚美尼亚德拉姆)为0.002美元
1.000 ANG(荷兰安的列斯盾)是0.562美元
1.000 AOA(Angolan Kwanza)是0.006美元
1.000 ARS(阿根廷比索)是0.057美元
1.000 AUD(Australian Dollar)是0.782美元
1.000 AWG(Aruban Florin)是0.557美元
1.000 AZN(阿塞拜疆马纳特)是0.588美元
1.000 BAM(波斯尼亚和黑塞哥维那可兑换马克)是0.601美元
1.000 BBD(巴巴多斯元)是0.500美元
1.000 BDT(Bangladeshi Taka)是0.012美元
1.000 BGN(保加利亚列弗)是0.600美元
1.000 BHD(巴林第纳尔)是2.652美元

STOXR-example-use2.png


要非常容易地使用Excel,如下所示:


STOXR-example-use-Excel.png


作为文字:

PS C:\> Get-STOXRCurrencyList | ForEach-Object {
    Convert-STOXRCurrency-金额1-从USD-到$ _。Name
} | Export-Csv -UseCulture -Path C:\temp\currencies.csv -NoTypeInformation

PS C:\> C:\temp\currencies.csv

内置帮助

请记住,您将需要使用的所有功能都有默认的内置帮助,因此您始终可以键入:

获取帮助Verb-STOXRFunctionName

例如。:

获取帮助集-STOXRAppID

当前形式的软件并未针对资源使用方面的速度或效率进行优化,但提供了极大的便利,并为您节省了编写大量代码来执行类似任务的繁琐任务,可能比我投资的功能少也需要时间。

STOXR完全由PowerShell构建,Microsoft Windows操作系统中的内置外壳,脚本语言和自动化框架,因此非常易于自动化。它也可以与其他访问这些PowerShell功能的.NET语言无缝集成,以完成繁重的工作-例如C#和VB.NET。如果需要,还可以将其与ASP.NET和其他Web框架集成。

要求

  • PowerShell / Windows管理框架版本3或更高版本。
  • .NET Framework 4.0或更高版本(PowerShell版本3必需)。
  • Open Exchange Rates应用程序ID / API密钥(注册这里 在他们的网站上-他们有无限期使用的免费计划-并且不发送垃圾邮件)。
  • 通过Web访问Open Exchange Rates API。
  • 可选的STOXR软件模块许可证密钥,用于解锁全部功能。看到文章的底部 为了那个原因。

注意! 代理功能目前未经测试,因为我无法访问具有这种性质的测试环境。

试用版的局限性

  • STOXR的试用版只能在一种货币(默认为USD)和另一种货币之间进行双向兑换。这意味着您可以从USD转换为GBP,从USD转换为EUR,反之亦然,但不能直接从GBP 转换为EUR。在注册版本中,此限制不存在,您可以在所有货币之间自由转换。在撰写本文时(2020年2月),Open Exchange Rates API中有175种可用货币。
  • 试用货币可以每12小时更改一次。第一个更改立即可用。
  • -FuzzyInput参数在试用版中无法正常工作,它将始终抱怨一种货币不是USD或当前设置的试用货币。

所有导出的功能/命令

PS C:\> Get-Command -Module STOXR | Format-Table -AutoSize

CommandType名称版本源
----------- ----                   ------- ------
函数Convert-STOXRCurrency 1.0.0.7 stoxr
函数Get-STOXRAppID 1.0.0.7 stoxr
函数Get-STOXRCacheInterval 1.0.0.7 stoxr
函数Get-STOXRCurrencyList 1.0.0.7 stoxr
函数Get-STOXRDebugInfo 1.0.0.7 stoxr
函数Get-STOXRProxy 1.0.0.7 stoxr
函数Get-STOXRTrialCurrency 1.0.0.7 stoxr
功能寄存器-STOXR 1.0.0.7 stoxr
函数集STOXRAppID 1.0.0.7 stoxr
函数集STOXRCacheInterval 1.0.0.7 stoxr
函数集STOXRProxy 1.0.0.7 stoxr
函数集STOXRTrialCurrency 1.0.0.7 stoxr
功能Unregister-STOXR 1.0.0.7 stoxr

注意! 代理功能目前未经测试!如有必要,我会在收到反馈后进行调查。我目前无法访问这样的测试环境。

模糊货币名称匹配

在试用版中,这不能正常工作。尝试使用试用版的模糊试用货币时,您将获得以下错误:

PS C:\> $Result = Convert-STOXRCurrency -Amount 1 -FromCurrency "united states" -ToCurrency swedish
警告:此产品未注册,因此存在以下限制:“发件人”或“发件人”货币必须为“ USD”(默认美元),并且-FuzzyInput不起作用。可以使用Set-STOXRTrialCurrency命令每12小时更改一次试用货币。注册产品以解锁全部功能。

如果您指定货币缩写“ USD”或您更改为的试验货币,则可以与其他货币进行模糊匹配。

注册软件

转到我的销售和许可证检索链接提供商MyCommerce / Share-It点击这里 并购买所需的许可证,然后使用命令Register-STOXR注册软件。注册不需要互联网访问,但首先需要获得许可证。

在这里,我使用功能Register-STOXR使用许可证来注册软件。

PS C:\> help Register-STOXR

名称
    寄存器STOXR
    
概要
    使用您购买和获得的许可证密钥注册Svendsen Tech
    打开汇率模块。
    这样可以解锁全部功能,并允许您在
    任何/多种货币。
    
    
句法
    Register-STOXR [[-LicenseKey] <String>] [-RefreshUsingExistingLicense] 
    [<CommonParameters>]

...然后我像这样注册:

PS C:\> Register-STOXR -LicenseKey 'xxxxx-xxxxxxxxxxxx-xxxxxxxxxx'
成功注册了Svendsen Tech Open Exchange Rates模块。

然后我们回到模糊匹配

如果输入的文本中有空格,则需要用引号将其引起来。单引号或双引号有效(和其他unicode引号)。

这次,它的效果更好。

PS C:\> $Result = Convert-STOXRCurrency -Amount 1 -FromCurrency "united states" `
    -ToCurrency瑞典文
警告:执行将货币兑换数据刷新间隔设置为30 * 60秒(30分钟)的首次运行操作。使用Set-STOXRCacheInterval进行更改。


PS C:\> $Result


发件人金额 : 1.0000
FromAmountNumerical : 1
来自货币 : 美元
FromCurrencyText : 美国美元
金额 : 8.0393
到数值 : 8.039254
货币兑换 :瑞典克朗
ToCurrencyText :瑞典克朗
FromCurrencyPerUSD : 1.0000
美元兑货币 : 8.0393
日期 : 2017-09-26 03:49:05
精确 : 4

多个模糊货币匹配

如果从货币对到货币对不止一种,则将向您显示警告和根据我的算法匹配的所有货币的列表。

英镑,美元和斯堪的纳维亚货币的示例(克朗/克朗-顺便说一句“皇冠”,是对大众的一些随机语言阐释):

PS C:\> Convert-STOXRCurrency 1 USD -To pound
警告:“至”货币多次点击(12):
EGP,埃及镑
FKP,福克兰群岛磅
英镑,英镑
GGP,根西岛镑
GIP,直布罗陀磅
IMP,马克斯磅
JEP,泽西镑
LBP,黎巴嫩镑
SDG,苏丹镑
SHP,圣赫勒拿镑
SSP,南苏丹镑
SYP,叙利亚镑

PS C:\> Convert-STOXRCurrency 1 USD -To dollar
警告:“至”货币多次点击(23):
澳元,澳大利亚元
BBD,巴巴多斯元
BMD,百慕大元
BND,文莱元
BSD,巴哈马元
BZD,伯利兹元
加元,加拿大元
FJD,斐济元
GYD,圭亚那元
港币,港元
JMD,牙买加元
KYD,开曼群岛元
LRD,利比里亚元
NAD,纳米比亚元
NZD,新西兰元
SBD,所罗门群岛元
SGD,新加坡元
SRD,苏里南元
TTD,特立尼达和多巴哥元
TWD,新台币
USD,美元
XCD,东加勒比元
ZWL,津巴布韦元

PS C:\> Convert-STOXRCurrency 1 USD -To kron
警告:“至”货币多次点击(3):
DKK,丹麦克朗
NOK,挪威克朗
SEK,瑞典克朗

当前支持的所有货币的列表

使用命令Get-STOXRCurrencyList列出要转换的所有可用货币。这完全取决于Open Exchange Rates API中的可用内容。该列表是动态检索的,而不是硬编码的。

截至2020-02-28,清单如下:

PS C:\temp> Get-STOXRCurrencyList -AutoSizeTable                                                                        
名称说明
---- -----------
AED阿拉伯联合酋长国迪拉姆
AFN阿富汗阿富汗尼
所有阿尔巴尼亚列克
AMD亚美尼亚德拉姆
ANG荷兰安的列斯盾
AOA安哥拉宽扎
ARS阿根廷比索
AUD澳大利亚元
AWG阿鲁班·弗洛林(AWG Aruban Florin)
AZN阿塞拜疆马纳特
BAM波斯尼亚和黑塞哥维那可兑换商标
BBD巴巴多斯元
BDT孟加拉塔卡
BGN保加利亚列弗
BHD巴林第纳尔
BIF布隆迪法郎
BMD百慕大元
BND文莱元
BOB玻利维亚人Boliviano
BRL巴西雷亚尔
BSD巴哈马元
BTC比特币
BTN不丹Ngultrum
BWP博茨瓦纳普拉
BYN白俄罗斯卢布
BZD伯利兹元
CAD加拿大元
CDF刚果法郎
CHF瑞士法郎
CLF智利会计单位(UF)
中电智利比索
CNH人民币(离岸)
人民币人民币
COP哥伦比亚比索
CRC哥斯达黎加科隆
CUC古巴可兑换比索
银联古巴比索
CVE佛得角埃斯库多
CZK捷克克朗
DJF吉布提法郎
DKK丹麦克朗
DOP多米尼加比索
DZD阿尔及利亚第纳尔
EGP埃及镑
ERN厄立特里亚纳克法
ETB埃塞俄比亚比尔
EUR欧元
FJD斐济元
FKP福克兰群岛磅
GBP英镑
GEL格鲁吉亚拉里
GGP根西岛磅
GHS加纳塞地
GIP直布罗陀磅
GMD冈比亚达拉西
GNF几内亚法郎
GTQ危地马拉格查尔
GYD圭亚那元
HKD港元
HNL洪都拉斯伦皮拉
HRK克罗地亚库纳
HTG海地古德
HUF匈牙利福林
IDR印尼盾
ILS以色列新谢克尔
IMP马克斯磅
INR印度卢比
IQD伊拉克第纳尔
IRR伊朗里亚尔
ISK冰岛克朗
JEP球衣磅
JMD牙买加元
JOD约旦第纳尔
JPY日元
KES肯尼亚先令
KGS吉尔吉斯斯坦索姆
KHR柬埔寨瑞尔
KMF科摩罗法郎
KPW朝鲜元
韩元韩元
科威特第纳尔(KWD)
KYD开曼群岛元
哈萨克斯坦坚戈(KZT)
LAK老天基普
LBP黎巴嫩镑
LKR斯里兰卡卢比
LRD利比里亚元
LSL莱索托洛蒂
LYD利比亚第纳尔
MAD摩洛哥迪拉姆
MDL摩尔多瓦列伊
MGA马达加斯加人的领土
MKD马其顿代纳尔
MMK缅甸缅元
MNT蒙古图格里克
澳门币澳门币
MRO毛里塔尼亚Ouguiya(2018年前)
MRU毛里塔尼亚Ouguiya
MUR毛里求斯卢比
MVR马尔代夫拉菲亚
MWK马拉维克瓦查
MXN墨西哥比索
MYR马来西亚林吉特
MZN莫桑比克梅蒂卡尔
NAD纳米比亚元
NGN尼日利亚奈拉
NIO尼加拉瓜科尔多瓦
NOK挪威克朗
NPR尼泊尔卢比
NZD新西兰元
OMR阿曼里亚尔
PAB巴拿马巴波亚
PEN秘鲁新索尔
PGK巴布亚新几内亚基纳
PHP菲律宾比索
PKR巴基斯坦卢比
PLN波兰兹罗提
PYG巴拉圭瓜拉尼
QAR卡塔尔里亚尔
RON罗马尼亚列伊
RSD塞尔维亚第纳尔
RUB俄罗斯卢布
卢旺达卢旺达法郎
沙特阿拉伯里亚尔
SBD所罗门群岛元
SCR塞舌尔卢比
SDG苏丹镑
SEK瑞典克朗
SGD新加坡元
SHP圣赫勒拿镑
SLL塞拉利昂利昂
SOS索马里先令
SRD苏里南元
SSP南苏丹镑
STD  S?o Tomé and Príncipe Dobra (pre-2018)
STN  S?o Tomé and Príncipe Dobra
SVC萨尔瓦多科隆
SYP叙利亚镑
SZL斯威士兰·利兰加尼
泰铢
TJS塔吉克斯坦尼Somoni
TMT土库曼斯坦马纳特
TND突尼斯第纳尔
TOP汤加潘加
TRY土耳其里拉
TTD特立尼达和多巴哥元
TWD新台币
TZS坦桑尼亚先令
UAH乌克兰格里夫纳
UGX乌干达先令
USD美元
UYU乌拉圭比索
UZS乌兹别克斯坦索姆
VEF委内瑞拉玻利瓦尔·富埃特(旧)
VES委内瑞拉玻利瓦尔·索贝拉诺
VND越南盾
VUV瓦努阿图瓦图
WST萨摩亚塔拉
XAF非洲金融共同体法郎
XAG银盎司
XAU金盎司
XCD东加勒比元
XDR特别提款权
XOF非洲金融共同体法郎BCEAO
XPD钯盎司
XPF CFP法郎
XPT白金盎司
也门里亚尔
ZAR南非兰特
ZMW赞比亚克瓦查
ZWL津巴布韦元

完整版本中的-FuzzyInput参数

如果要以更像人类的字符串输入文本,也可以使用-FuzzyInput参数来执行此操作,但是在试用版中不起作用。

PS C:\> Convert-STOXRCurrency -FuzzyInput '1 norwegian in swedi'


发件人金额 : 1.0000
FromAmountNumerical : 1
来自货币 :挪威克朗
FromCurrencyText :挪威克朗
金额 : 1.0282
到数值 : 1.0282331179854788244260769276
货币兑换 :瑞典克朗
ToCurrencyText :瑞典克朗
FromCurrencyPerUSD : 7.8185
美元兑货币 : 8.0393
日期 : 2017-09-26 03:49:05
精确 : 4

-AsString和-Precision参数

如果要以更简明易懂的字符串格式返回货币换算结果,则可以使用参数-AsString,并且我还将演示参数-Precision的工作方式。

PS C:\> Convert-STOXRCurrency 1 dkk nok -AsString
1.0000丹麦克朗(丹麦克朗6.2739 / USD)为1.2459 NOK(挪威克朗7.8169 / USD)。日期:2017-09-26 04:19:19。

仅使用“ -Precision 2”四舍五入到两位数。

PS C:\> Convert-STOXRCurrency 1 dkk nok -AsString -Precision 2
1.00 DKK(丹麦克朗为6.27 / USD)为1.25 NOK(挪威克朗,7.82 / USD)。日期:2017-09-26 04:19:19。

PS C:\> Convert-STOXRCurrency 1 usd dkk -Precision 2


发件人金额 : 1.00
FromAmountNumerical : 1
来自货币 : 美元
FromCurrencyText : 美国美元
金额 : 6.27
到数值 : 6.27387
货币兑换 :丹麦克朗
ToCurrencyText :丹麦克朗
FromCurrencyPerUSD : 1.00
美元兑货币 : 6.27
日期 : 2017-09-26 04:19:19
精确 : 2

潜在用途和功能

  • 使用.NET Framework软件和PowerShell,以编程方式轻松转换货币。
  • 开放汇率(OXR)可靠地提供的货币的完整列表。简易的应用程序ID / API密钥注册。无垃圾邮件。注册这里 (提供免费计划)。
  • 模糊/部分货币与名称/描述匹配。
  • 作为自动化工具,几乎具有完整的功能。
  • 使用Windows计划的任务,服务或仅通过手动或自动启动的while循环,一次或按时间针对特定时间范围收集的货币数据来构建CSV文件(Get-Help Export-Csv)。
  • Excel报表很容易,因为CSV文件是Excel本身读取的。使用PSExcel PowerShell模块或类似的模块直接创建XLS / XLSX文件。
  • 使用STOXR生成具有所需货币汇率的HTML报告(获取帮助-ConvertTo-Html,然后在-Head中添加一些CSS)。
  • 莲实克蕾儿
  • 将此软件与其他软件结合使用,可以随时间建立货币图表。 Svendsen Tech计划构建一个GUI并将其包括在内,但目前尚无时间估算。

下载和/或购买许可证

  • STOXR.zip下载 -下载该软件的试用版。解锁全部功能所需的是稍后的文本许可证密钥。请记住在解压缩之前要取消阻止zip文件。

您始终可以在此处下载最新版本,也可以从PowerShell画廊下载最新版本,在此处我将使软件保持最新。除非我提供明显不同的产品(GUI和图形位于待办事项列表上),否则新密钥将适用于新软件,并且新许可证将适用于该产品。以前的客户可以免费获得它,也可以享受很大的折扣。

如果您具有Windows Management Framework 5 / PowerShell版本5或更高版本(Windows 10 / Server 2016及更高版本中的默认设置),则可以从Microsoft的PowerShell画廊网站 该版本还在试用版中发布过:

This requires an admin console and installs for all users, by default in $Env:ProgramFiles\WindowsPowerShell\Modules.

安装模块-名称STOXR

或仅在用户的个人资料目录中安装:

安装模块-名称STOXR-范围CurrentUser

或将模块更新为最新版本(您需要在更新版本中重新输入App ID,将调查从找到的最新先前版本中自动检索并自动将其安装到新版本中,或提示安装该版本的提示可能不是您想要的行为):

更新模块-名称STOXR

或下载并检查代码:

Save-Module -Name STOXR -Path X:\SomeDirectory\STOXR


STOXR的定价模型如下:

  • 1个站点/个人许可证: 美元$9.99 (几乎免费!)或9.99欧元。


Order-now-button.png


一份许可授权您无限期自由使用该软件,并结合您和您达成的Open Exchange Rates条款,当您在其网站上注册App ID / API密钥时,它们均同意(注册这里)。提供免费计划-没有垃圾邮件。

“使用”是指在一个(一部分)组织/公司内或作为一个私人。

单击此处获取许可条款。这是一个简单的,经过稍微修改的MIT许可证。

如有疑问,请联系斯文森科技 at sales@svendsentech.no or support@svendsentech.no (alternative mail: svendsentech@gmail.com ).

我的销售和许可证密钥提供者是Digital River公司MyCommerce / Share-It。

您可以通过单击此链接购买软件, 或上面的订购按钮,完成付款过程并立即访问许可证密钥。

要与MyCommerce客户服务联系并参考我的供应商ID,请使用这个连结.

版本历史:档案:STOXR.zip

  • 最新更新
    • v1.0.1.8。 2017-10-18 修复代理默认凭据处理。次要修复程序。没有更多的别名。
    • v1.0.1.6。 2017-10-15 修复破坏语法错误。


关键字:转换货币,.NET,CSV,Excel中的货币转换器软件,将USD转换为EUR,.xls,.xlsx,货币转换软件,将EUR转换为USD,在任何货币,货币,所有货币之间进行转换,.NET货币转换软件,商业,商业软件,ASP.NET,VB.NET,C#,F#,Visual Basic,自动化框架,Microsoft Windows,PowerShell / .NET,金盎司汇率(XAU),铂金,银盎司(XAG)交换费率,PowerShell版本3,比特币,日元,日元,澳元,欧元,.NET框架,银行,银行业务,金融,金融货币转换,企业,全面的货币列表,将USD转换为任何货币,免费试用货币软件,共享软件,自动化,DevOps,对象,PowerShell对象

莲实克蕾儿