周五乐趣：数字运算

本周早些时候，我在讨论一个新项目时浏览了 GoFundMe 网站。我对此类网站的考虑因素之一是所涉及的费用。当然，我不希望这种服务是免费的。但我开始想知道净捐款会是什么样子。根据 GoFundMe 的说法，假设我的解释正确，该网站会直接抽取 5% 的捐款。除此之外，还有捐款 2.9% 的处理费加 30 美分。至少对于美国来说是这样。因此，对于 10 美元的捐款，净捐款将为 8.91 美元。

10 - (10*.05) - (10*.029 +.30)

那么好吧。这应该足够简单，可以变成 PowerShell 函数。

Function FundIt {
[cmdletbinding()]

Param(
[Parameter(Position=0,Mandatory,ValueFromPipeline)]
[double]$Donation,
[alias("currency")]
[Switch]$UseCurrency
)

Begin {
    Write-Verbose "Starting: $($MyInvocation.Mycommand)" 
     
    #define rates
    $GFMRate = .05
    $WePay = .029
    $PerTransaction = .30

} #begin

Process {
    Write-Verbose "Calculating donation of `$$Donation"
    
    $GFM = $donation * $GFMRate
    $Processing = [math]::Round(($Donation * $WePay) + $PerTransaction,2)
    $NetDonation = [math]::Round( $Donation - $GFM - $Processing,2)

    if ($UseCurrency) {
        #Imporant: the values will be treated as strings
        [pscustomobject]@{
          Donation = "{0:c2}" -f $Donation
          Fees = "{0:c2}" -f  ($GFM + $Processing)
          NetDonation = "{0:c2}" -f $NetDonation
        }
    }
    else {
        [pscustomobject]@{
          Donation = $Donation
          Fees = $GFM + $Processing
          NetDonation = $NetDonation
        }
    }

} #process

End {
    Write-Verbose "Ending: $($MyInvocation.Mycommand)"
} #end

} #close function

这也应该成为一个有趣的学习机会。

该函数采用捐赠金额参数。如果有人可能捐赠 10.25 美元，我会将其设置为 [double]。如果使用 [int] PowerShell，它将变成 10 美元。我稍后会回到另一个参数。

我将 GoFundMe 的费率定义为变量。这使得计算某些值变得更加容易。

$GFM = $donation * $GFMRate
$Processing = [math]::Round(($Donation * $WePay) + $PerTransaction,2)
$NetDonation = [math]::Round( $Donation - $GFM - $Processing,2)

您会注意到我正在使用 .NET Math 类的 Round() 方法。这样结果就会被格式化为小数点后两位。这是我想看到的，不一定是网站的运作方式。使用这些值我可以创建一个自定义对象。

[pscustomobject]@{
    Donation = $Donation
    Fees = $GFM + $Processing
    NetDonation = $NetDonation
}

这是一个简单的演示，是的，我知道我没有使用标准函数名称，但这只是为了好玩。

我还将该函数编写为高级函数，以便我可以将值传递到其中。如果您查看 $Donation 的参数定义，您会发现我有一个 ValueFromPipeline 设置。

这使得每次捐赠都会发生什么变得非常清楚。但我最终得到了什么？我的函数将对象写入管道，以便我可以使用其他 cmdlet，例如 Measure-Object。

这是有趣的部分：我可以测量多个属性。

10,5,2,5,5,15 | fundit | 
measure-object -property Donation,Fees,netdonation -sum | 
Select Property,Sum,Count

我认为这非常方便。

我知道这些值以美元为单位。但假设我正在创建一个报告，我想让它变得漂亮并包含 $符号，或者任何我的货币符号。

如果您还记得的话，我添加了一个名为 UseCurrency 的开关参数以及货币参数别名。

[alias("currency")]
[Switch]$UseCurrency

如果我使用 -UseCurrency 运行该函数，则该参数的值为 $True。这就是 Switch 参数的工作原理。在我的函数中，我可以测试参数值，如果它为真，那么我将创建相同的自定义对象，只不过我将使用 -F 运算符将值格式化为使用货币符号的字符串。

if ($UseCurrency) {
    #Imporant: the values will be treated as strings
    [pscustomobject]@{
        Donation = "{0:c2}" -f $Donation
        Fees = "{0:c2}" -f  ($GFM + $Processing)
        NetDonation = "{0:c2}" -f $NetDonation
    }
}

该运算符用于格式化 .NET Framework 中的字符串。您可以在线阅读有关此内容的更多信息：http://go.microsoft.com/fwlink/?LinkID=166450。但简而言之，运算符左侧的 {0} 是一个编号占位符。 c 是修饰符，在本例中指示使用货币格式字符串，我将其限制为 2 个位置。我可能不需要它，因为我已经四舍五入了，但为了教育目的我把它留下了。 -f 运算符的右侧是一个逗号分隔的值列表，它将“插入”占位符。最终结果是这样的：

这看起来很漂亮，但请注意这些值是字符串。

这意味着我之前的求和方法将会失败。相反，我需要使用数字，然后格式化结果。

10,5,2,5,5,15 | fundit | 
measure-object -property Donation,Fees,netdonation -sum | 
Select Property,@{Name="Total";Expression={ "{0:c}" -f $_.sum}},Count

现在我拥有了最好的一切。尽管如果我真的想制作一份漂亮的报告，我可以使用 Format-Table，以便我可以指定自定义属性的对齐方式。

10,5,2,5,5,15 | fundit | 
measure-object -property Donation,Fees,netdonation -sum | 
Format-Table Property,
@{Name="Total";Expression={ "{0:c}" -f $_.sum};Align="Right"},Count

我希望您觉得这很有趣并且内容丰富。如果您对我的做法或原因有任何疑问，请在评论中提出。