自作プラグイン/addval.inc.php

addval.inc.php†

サマリ	値の加算と平均値の算出をします．
リビジョン	1.0
対応バージョン	1.4.7
投稿者	hadacchi
投稿日	2009-12-31 (木) 02:29:43

↑

概要†

値の加算と平均値の算出をします．

ラベルと共に呼び出し，ラベル毎に値の合計と平均，呼び出し回数を表示します．
これは， hadacchi が自身の勤務管理のために作成したものですので，
機能が限定的であったり，特化していたりします．

プラグインの作成にあたっては，次のページを参考にさせていただきました．
PukiWiki/Plug-inの仕様 - PukiWiki-dev

↑

使うための準備（導入手順）†

下記のダウンロードからダウンロードしたファイルのファイル名を addval.inc.php へ変更する．
pukiwiki/plugin フォルダへ addval.inc.php を追加する．

↑

使い方†

ページ内で次のように呼び出すことで，ラベル val1 と val2 それぞれと対応する値の合計を計算します．
```
#addval(val1,100)
#addval(val1,13.0)
#addval(val2,1.30)
#addval(val2,-2)
```
数字の代わりに total と入力することで，代入された値の合計値を表示できます．
ただし， total を呼び出した行より上の行までの合計しか計算されません．
total は省略できます．
total の後ろへ更に整数を入力することで，小数点以下の精度を指定できます．
```
#addval(val1,total)   // 113
#addval(val2)         // -1
#addval(val2,total,2) // -0.70
```
数字の代わりに avg と入力することで，代入された値の平均値を表示できます．
ただし， avg を呼び出した行より上の行までの平均値しか計算されません．
total と同様に精度を指定できます．
```
#addval(val1,avg)     // 56
#addval(val2,avg,3)   // -0.350
```
数字を用いたラベルの呼び出し回数を表示できます．
total, avg, count の呼び出しは回数としてカウントされません．
count を呼び出した行より上の行までの呼び出し回数しか計算されません．
```
#addval(val1,count)   // 3
```

数字が無効な場合は，呼び出しとしてカウントされません．

#addval(val3,1.30)
#addval(val3,-2..0)
#addval(val3,+2.0)    // `+' の入力は不可
#addval(val3,avg,1)   // 1.3
#addval(val3,count)   // 1

時間フォーマット（00:00 の形式）で入力すると，時間（hour）単位の合計と平均を計算できます．
```
#addval(val4,13:00)   // 13 hour
#addval(val4,1:30)    // 1.5 hour
#addval(val4,total,2) // 14.50
#addval(val4,avg,2)   // 7.25
```

↑

使用例†

次のように入力すると…

|date|hour|h
|12/29|#addval(200912,11:00)|
|12/30|#addval(200912,7:30)|
|12/31|#addval(200912,8:45)|
|平均労働時間|#addval(200912,avg,2)|
|総労働時間|#addval(200912,total,2)|
|出勤日数|#addval(200912,count)|

次のように出力されます．