dateAdd関数
本ページには広告が含まれています。
- 日付
日時(date)に、指定した単位(interval)の時間(num)を加算して返します。正の値で未来、負の値で過去になります。戻り値は計算した結果の時刻部分が00:00:00のときは日付のみ、それ以外の場合は日時を返します。
- 構文
- UString = dateAdd( interval, num, date )
- 引数
- interval
必須
- 加算する時間間隔を表す文字列式(yyyy:年、m:月、d:日、ww:週、h:時、n:分、s:秒)
- num
必須
- dateに加算する値。未来は正、過去は負で指定
- date
必須
- 時間間隔を加算する日付
- 戻り値
- 日時(date)に、指定した単位(interval)の時間(num)を加算して返します
プログラム
解説
- 2行目
- 年、月、日、戻り値の日付を代入する変数。
- 3行目
- GETTIMEでdateの日付を特殊変数にセットします。
- 5-6,9,27,30,33,36,39,42行目
- intervalの値によって分岐。yyyy(年)なら7行目>>>、m(月)なら10行目>>>、d(日)なら28行目>>>、ww(週日)なら31行目>>>、h(時)なら34行目>>>、n(分)なら37行目>>>、s(秒)なら40行目>>>。
- 7-8行目
- dateの年にnumを加算。
- 10-26行目
-
- 28-29行目
- GETTIME関数で第一引数に加算する日数を指定し、特殊変数から日付を取得。
- 31-32行目
- GETTIME関数で第一引数に加算する週数×7を指定し、特殊変数から日付を取得。
- 34-35行目
- GETTIME関数で第一引数に加算する時間/24を指定し、特殊変数から日付を取得。
- 37-38行目
- GETTIME関数で第一引数に加算する分数/1440を指定し、特殊変数から日付を取得。1日=1,440分。
- 36-38行目
- GETTIME関数で第一引数に加算する秒数/86400を指定し、特殊変数から日付を取得。1日=86,400秒。
- 40-41行目
- dを戻り値として返す。
複数の時間間隔や文字列形式の日時を加算
加算する時間間隔が単一でないもしくは文字列形式の日時を加算する場合、dateValue関数 (自作関数)やtimeValue関数 (自作関数)でシリアル値に変換した値をnumに指定します。シリアル値は1日を1とする値なのでintervalにはdを指定します。
- 結果
使い方
- 結果
2021/12/03
2027/01/18 13:12:41
2026/11/26
2021/10/27
プログラム実行例
今週の土曜日の日付を求める
まずgetWeekday関数で曜日番号(日曜:0〜土曜:6)を求め、今日の日付から引くことで今週の日曜日の日付を求めます。
-1 * getWeekday(date)で今週の日曜日を求めてます。
その日付から求めたい曜日の曜日番号を加えることで、目的の日付を求められます。
今年の残りの日数を求める
2週間後の月曜日の日付を求める
まず-1 * getWeekday(date)で今週の日曜日を求めます。
今週の日曜日を求めてから、w * 7 + nを加算することでn週間後のw曜日を求めることができます。
wは0(日曜日)〜6(土曜日)の曜日番号で指定。
明日(1日後)の日付を求める
昨日(1日前)の日付を求める
来週の日曜日と土曜日の日付を求める
メール本文からURLを取得(Outook)
メールの本文から正規表現でURL部分のみを取得します。
使用関数
- DIM (1, 2, 3, 8, 10, 12, 15, 22行目)
- ローカル変数を宣言します。
- CREATEOLEOBJ関数 (スクリプト関数) (1行目)
- COMオブジェクトを生成します。
- Application.GetNamespace メソッド (2行目)
- 指定した種類のNameSpace オブジェクトを返します。
- (3行目)
- GETTIME関数 (スクリプト関数) (7行目)
- 日付、時間を取得します。
- dateAdd関数 (自作関数) (12行目)
- 日時に、指定した単位の時間を加算して返します。
- FOR-TO文 (20, 21, 22, 23, 24, 25, 26, 27行目)
- 条件が真の間、処理を繰り返し実行します。途中でループを抜けたいときはBREAK文を使います。
- WITH文 (21行目)
- reExecute関数 (自作関数) (22行目)
- 正規表現 検索を行います。
- FOR-IN文 (23, 24, 25行目)
- 配列の要素分だけ処理を繰り返します。FOR文でも書き換えられます。
- PRINT文 (24行目)
- UWSC.LOGにログを出力します。
- コメント (4, 6, 9, 11, 14, 17行目)
- プログラムの動作に影響しない注釈を残すことができます。プログラムの内容を説明したり、デバッグや修正のために一時的にコードを無効化ときにも使えます。
- 特殊文字 (8, 10行目)
指定した日付の週の日曜日と土曜日の日付を求める
使用関数
- DIM (1行目)
- ローカル変数を宣言します。
- PRINT文 (2, 3行目)
- UWSC.LOGにログを出力します。
- dateAdd関数 (自作関数) (2, 3行目)
- 日時に、指定した単位の時間を加算して返します。
- getWeekday関数 (2, 3行目)
- 引数に指定された日付の曜日番号(0:日曜〜6:土曜)を返します。
- コメント (1行目)
- プログラムの動作に影響しない注釈を残すことができます。プログラムの内容を説明したり、デバッグや修正のために一時的にコードを無効化ときにも使えます。
指定した日付の月初めと月末の日付を求める
過去7日間に受信した迷惑メールの受信日時とメールアドレスを取得
使用関数
- DIM (1, 2, 3, 4, 5, 6, 7行目)
- ローカル変数を宣言します。
- CREATEOLEOBJ関数 (スクリプト関数) (1行目)
- COMオブジェクトを生成します。
- Application.GetNamespace メソッド (2行目)
- 指定した種類のNameSpace オブジェクトを返します。
- (3行目)
- dateAdd関数 (自作関数) (4, 5行目)
- 日時に、指定した単位の時間を加算して返します。
- today関数 (自作関数) (4, 5行目)
- 今日の日付を返します。
- FOR-TO文 (11, 12, 13, 14, 15行目)
- 条件が真の間、処理を繰り返し実行します。途中でループを抜けたいときはBREAK文を使います。
- WITH文 (12行目)
- PRINT文 (13行目)
- UWSC.LOGにログを出力します。
ビットマップ画像を補色に変換(24ビット)
使用関数
- PUBLIC (1, 2, 3, 4行目)
- グローバル変数を宣言します。
- 定数定義 (6行目)
- DIM (8, 9, 10, 11, 13, 19, 57, 58, 59, 60行目 他2行)
- ローカル変数を宣言します。
- getBitmap関数 (自作関数) (9行目)
- 引数に指定したビットマップ画像のサイズ・幅・高さ・ビットの深さを配列で返します。
- CREATEOLEOBJ関数 (スクリプト関数) (13, 57行目)
- COMオブジェクトを生成します。
- WITH文 (15, 53行目)
- スレッド生成 (23行目)
- スレッドを生成します。処理を並行して行いたいときに使います。
- text関数 (自作関数) (25, 72, 75行目)
- 数値を表示書式に基づいて変換した文字列を返します。
- now関数 (自作関数) (25行目)
- 現在の日時のシリアル値を返します。
- FOR-TO文 (28, 29, 30, 31, 32, 33, 34, 35, 36, 37行目 他13行)
- 条件が真の間、処理を繰り返し実行します。途中でループを抜けたいときはBREAK文を使います。
- 例外処理 (35行目)
- decToHex関数 (自作関数) (36, 44行目)
- 10進数を16進数に変換します。負数・小数の値にも対応しています。
- BREAK文 (38行目)
- BREAK文はFOR文、WHILE文、REPEAT文のループ内から抜け出したいときに使います。
- IIF関数 (自作関数) (40, 75, 76行目)
- 式を評価して値を返します。
- LENGTH関数 (スクリプト関数) (40行目)
- 文字数もしくは配列サイズを返します。
- hexToDec関数 (自作関数) (42, 46行目)
- 16進数を10進数に変換します。負数・小数の値にも対応しています。
- complementaryColor関数 (自作関数) (43行目)
- RGBの各成分、Color値、もしくは#RRGGBB形式の文字列から補色を返します。返り値は引数と同じ形式で返します。
- COPY関数 (46行目)
- 文字列の一部を切り出します。
- PRINT文 (49行目)
- UWSC.LOGにログを出力します。
- FSO.GetParentFolderName メソッド (58行目)
- 指定したパスの最後のコンポーネントの親フォルダ名を返します。
- (59行目)
- 指定したフォルダまたはファイル名のベース名(パスの最後の\以降で拡張子を除いたもの)を取得します。
- FSO.GetExtensionName メソッド (60行目)
- 指定したパスの最後のコンポーネントのファイル拡張子名を返します。
- uniqueFilename関数 (自作関数) (62行目)
- 重複しないファイル名を生成します。
- PROCEDURE-FEND (66, 67, 68, 69, 70, 71, 72, 73, 74, 75行目 他4行)
- PROCEDUREは戻値のない自作関数を定義することができます。
- REPEAT文 (67, 68, 69, 70, 71, 72, 73, 74, 75, 76行目 他2行)
- ループ処理を行います。ループの終わりに条件判定を行うので、最低1度は処理が実行されます。後判定。
- GETTIME関数 (スクリプト関数) (68行目)
- 日付、時間を取得します。
- FUKIDASI関数 (スクリプト関数) (71行目)
- メッセージを吹出しに表示します。
- ROUND関数 (73行目)
- 指定した位置で偶数丸めした値を返します。
- INT関数 (75行目)
- 小数点以下を切り落とした数値を返します。
- dateAdd関数 (自作関数) (76行目)
- 日時に、指定した単位の時間を加算して返します。
- SLEEP関数 (77行目)
- 処理を待機します。
- 行結合 (71, 72, 73, 74, 75行目)
今週の日曜日の日付を求める
祝日データを追加します(Outlook)
使用関数
- 定数定義 (1行目)
- DIM (3, 4, 24, 27行目)
- ローカル変数を宣言します。
- CREATEOLEOBJ関数 (スクリプト関数) (3行目)
- COMオブジェクトを生成します。
- FOR-TO文 (23, 24, 25, 26, 27, 28, 29, 30, 31, 32行目 他2行)
- 条件が真の間、処理を繰り返し実行します。途中でループを抜けたいときはBREAK文を使います。
- UBound関数 (自作関数) (23行目)
- 配列の上限値(最大インデックス)を求めます。arraynameに配列の名前、dimensionに上限値を求める配列の次元を指定します。
- Application.CreateItem メソッド (24行目)
- 新しいOutlookのアイテムを表すオブジェクトを作成します。
- WITH文 (25行目)
- (26行目)
- 予定表の「件名」を取得または設定します。
- (28行目)
- 予定の開始日時を取得または設定します。
- dateAdd関数 (自作関数) (29行目)
- 日時に、指定した単位の時間を加算して返します。
- (29行目)
- 予定の終了日時を取得または設定します。
- (30行目)
- 終日予定ならばTrueを返します。
- (31行目)
- リマインダーを取得もしくは設定します。
- AppointmentItem.Save メソッド (32行目)
- 行結合 (4, 5, 6, 7, 8, 9, 10, 11, 12, 13行目 他7行)
四十九日法要
命日から四十九日法要の日付を求めます。四十九日は命日を1日目として49日目なのでnumは49-1とします。
以下は命日が2025/04/05のときの四十九日を求めています。
公開日:
更新日:
関連記事
- dateSerial関数 (自作関数)
- 引数に指定した年、月、日の日付が表すシリアル値を返します。
- getKyureki関数 (自作関数)
- 西暦から旧暦を求めます。
- chuki関数 (自作関数)
- 指定したユリウス日の直前の中気を求めます。
- JDToYMD関数 (自作関数)
- ユリウス日をグレゴリオ暦に変換します。
- YMDToJD関数 (自作関数)
- グレゴリオ暦をユリウス日に変換します。
- dateValue関数 (自作関数)
- 日付形式の文字列をシリアル値に変換します。
- getNthWeekday関数 (自作関数)
- 指定年月の第n週のw曜日(第nW曜日)の日付を返します。
- dateDiff関数 (自作関数)
- 指定された2つの日付の時間間隔を返します。
- dateString関数 (自作関数)
- 指定された日付を西暦から和暦に変換します。
- now関数 (自作関数)
- 現在の日時のシリアル値を返します。