role: Office Automation & Database Design Expert tone: Professional, Logical, Practical format: Structured Technical Documentation optimization: Win32 API compatibility (PtrSafe), Performance-focused VBA

VBAでミリ秒単位の処理時間を計測！Win32 APIを活用した高速化診断

【背景と目的】

大規模データ処理の際、標準のTimer関数では分解能が低く正確なボトルネック特定が困難です。Win32 APIで高精度な計測を行い、コード改善の効果を数値化します。

【処理フロー図】

graph TD
A["計測開始：Win32 API呼び出し"] --> B["Excel環境の最適化設定"]
B --> C["メイン処理：配列等を用いた高速演算"]
C --> D["Excel環境の復元"]
D --> E["計測終了：Win32 API呼び出し"]
E --> F["処理時間の算出・結果表示"]

【実装：VBAコード】

Option Explicit

' --- Win32 API 宣言 (64bit/32bit両対応) ---
' GetTickCountはOS起動からの経過時間をミリ秒単位で返します。
#If VBA7 Then
    Private Declare PtrSafe Function GetTickCount Lib "kernel32" () As Long
#Else
    Private Declare Function GetTickCount Lib "kernel32" () As Long
#End If

''' 

''' 高精度な時間計測を伴うデータ処理サンプル
''' 
Public Sub MeasureHighPrecisionTime()
    Dim startTime As Long
    Dim endTime As Long
    Dim processTime As Double

    ' 1. 計測開始
    startTime = GetTickCount()

    ' 2. Excel高速化設定（描画停止・自動計算停止）
    With Application
        .ScreenUpdating = False
        .Calculation = xlCalculationManual
        .EnableEvents = False
    End With

    On Error GoTo ErrorHandler

    ' --- [メイン処理：例として10万行の配列処理] ---
    Dim data(1 To 100000, 1 To 1) As Variant
    Dim i As Long

    For i = 1 To 100000
        ' 疑似的な計算処理
        data(i, 1) = i * 1.08 ' 税込計算の例
    Next i

    ' セルへの一括書き出し（セルへの逐次アクセスを避ける）
    ThisWorkbook.Worksheets(1).Range("A1").Resize(100000, 1).Value = data
    ' --------------------------------------------

    ' 3. 計測終了
    endTime = GetTickCount()

    ' ミリ秒を秒単位に変換
    processTime = (endTime - startTime) / 1000

CleanUp:
    ' 4. Excel環境の復元
    With Application
        .ScreenUpdating = True
        .Calculation = xlCalculationAutomatic
        .EnableEvents = True
    End With

    MsgBox "処理が完了しました。" & vbCrLf & _
           "実行時間: " & processTime & " 秒", vbInformation, "パフォーマンス計測"
    Exit Sub

ErrorHandler:
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical
    Resume CleanUp
End Sub

【技術解説】

1. Win32 API (GetTickCount): VBA標準の Timer 関数は午前0時からの秒数を返しますが、浮動小数点による誤差や解像度の限界（環境により約15ms程度）があります。GetTickCount はシステムタイマーに直結したミリ秒単位の整数値を返すため、より精密なパフォーマンステストに適しています。

2. PtrSafe属性: Office 2010以降の64bit版では、API宣言に PtrSafe キーワードが必須です。本コードでは条件付きコンパイルを使用して、互換性を確保しています。

3. 配列処理による高速化: セルへのアクセス（読み書き）は非常にコストが高い処理です。メモリ上の「配列」で計算を完結させ、最後に一括してセルへ戻すことで、API計測結果に劇的な改善（10倍〜100倍以上）が見られます。

【注意点と運用】

• ロールオーバーの制約: GetTickCount は32ビットの値を返すため、Windowsを約49.7日間連続起動していると数値が0にリセットされます。サーバー等の長時間稼働環境で極めて稀に不整合が起きる可能性があります。

• デバッグ時の注意: ScreenUpdating = False の状態でエラー終了するとExcelの描画が止まったままになります。必ず ErrorHandler 等で設定を戻す処理を記述してください。

• OS依存性: Win32 APIはWindows専用です。Mac版Excelでは動作しないため、マルチプラットフォーム環境では注意が必要です。

【まとめ】

1. ミリ秒単位の可視化: 曖昧な「体感」ではなく、具体的な数値でコードの優劣を判断する。

2. 環境最適化の徹底: 計測時は ScreenUpdating 停止などの定石を必ずセットで適用する。

3. 配列の活用: セル操作を最小限に抑える設計が、最も効果的な高速化手法である。