Addition function to get current datetime

happysoft2018 · happysoft2018 · commit 96a8796ac5f2 · 2025-10-05T15:56:39.000+09:00
diff --git a/USER_MANUAL.md b/USER_MANUAL.md
@@ -5,6 +5,8 @@
 - [Installation and Setup](#installation-and-setup)
 - [Basic Usage](#basic-usage)
 - [Query Definition File Structure](#query-definition-file-structure)
+- [Enhanced Dynamic Variables System](#enhanced-dynamic-variables-system)
+- [Automatic DateTime Variables](#automatic-datetime-variables)
 - [Advanced Features](#advanced-features)
 - [Template Style System](#template-style-system)
 - [Building and Deployment](#building-and-deployment)
@@ -409,6 +411,127 @@ WHERE CustomerID IN (${customerData.CustomerID})
 4. **Performance**: Variables are executed once and cached for the entire export
 5. **Debug Mode**: Enable with `DEBUG_VARIABLES=true` for detailed variable substitution
 
+## 🕒 Automatic DateTime Variables
+
+SQL2Excel provides built-in datetime variables that are automatically resolved to current time values. These variables can be used in queries, file names, and any text content.
+
+### Basic DateTime Functions
+
+| Variable | Description | Example Output |
+|----------|-------------|----------------|
+| `${CURRENT_TIMESTAMP}` | Current UTC timestamp | `2024-10-05 15:30:45` |
+| `${NOW}` | Current UTC timestamp | `2024-10-05 15:30:45` |
+| `${CURRENT_DATE}` | Current UTC date | `2024-10-05` |
+| `${CURRENT_TIME}` | Current UTC time | `15:30:45` |
+| `${GETDATE}` | SQL Server format | `2024-10-05 15:30:45` |
+
+### Korean Time Zone Functions
+
+| Variable | Description | Example Output |
+|----------|-------------|----------------|
+| `${KST_NOW}` | Korean Standard Time | `2024-10-06 00:30:45` |
+| `${KST_DATE}` | Korean date | `2024-10-06` |
+| `${KST_TIME}` | Korean time | `00:30:45` |
+| `${KST_DATETIME}` | Korean datetime | `2024-10-06 00:30:45` |
+
+### Korean Localized Formats
+
+| Variable | Description | Example Output |
+|----------|-------------|----------------|
+| `${KOREAN_DATE}` | Korean date format | `2024년 10월 6일` |
+| `${KOREAN_DATETIME}` | Korean datetime format | `2024년 10월 6일 00:30:45` |
+| `${KOREAN_DATE_SHORT}` | Short Korean date | `2024. 10. 06.` |
+| `${WEEKDAY_KR}` | Korean weekday | `일요일` |
+| `${MONTH_KR}` | Korean month | `10월` |
+| `${YEAR_KR}` | Korean year | `2024년` |
+
+### Formatted Date/Time Functions
+
+| Variable | Description | Example Output |
+|----------|-------------|----------------|
+| `${DATE_YYYYMMDD}` | Compact date format | `20241006` |
+| `${DATE_YYYY_MM_DD}` | Hyphenated date (KST) | `2024-10-06` |
+| `${DATETIME_YYYYMMDD_HHMMSS}` | Compact datetime | `20241006_003045` |
+| `${WEEKDAY_EN}` | English weekday | `Sunday` |
+
+### Timestamp Functions
+
+| Variable | Description | Example Output |
+|----------|-------------|----------------|
+| `${UNIX_TIMESTAMP}` | Unix timestamp | `1728140445` |
+| `${TIMESTAMP_MS}` | Milliseconds timestamp | `1728140445123` |
+| `${ISO_TIMESTAMP}` | ISO 8601 format | `2024-10-05T15:30:45.123Z` |
+| `${KST_ISO_TIMESTAMP}` | Korean ISO format | `2024-10-06T00:30:45.123Z` |
+
+### Usage Examples
+
+#### In XML Queries
+```xml
+<vars>
+  <var name="reportDate">${KOREAN_DATE}</var>
+  <var name="department">IT</var>
+</vars>
+
+<sheets>
+  <sheet name="DailyReport" use="true">
+    <![CDATA[
+      SELECT 
+        '${reportDate} 일일 리포트' as title,
+        '${KST_NOW}' as generated_at,
+        * FROM orders 
+      WHERE created_date >= '${DATE_YYYY_MM_DD}'
+        AND department = '${department}'
+    ]]>
+  </sheet>
+</sheets>
+```
+
+#### In JSON Queries
+```json
+{
+  "vars": {
+    "reportTitle": "Daily Report - ${KOREAN_DATE}",
+    "currentTime": "${KST_NOW}"
+  },
+  "sheets": [
+    {
+      "name": "Report_${DATE_YYYYMMDD}",
+      "query": "SELECT '${reportTitle}' as title, '${currentTime}' as generated_at FROM users"
+    }
+  ]
+}
+```
+
+#### For File Naming
+```xml
+<excel db="sampleDB" output="output/report_${DATE_YYYYMMDD}_${DATETIME_YYYYMMDD_HHMMSS}.xlsx">
+```
+
+#### In Query Conditions
+```sql
+-- Filter records from today (Korean time)
+SELECT * FROM orders 
+WHERE order_date >= '${DATE_YYYY_MM_DD} 00:00:00'
+  AND order_date < '${DATE_YYYY_MM_DD} 23:59:59'
+
+-- Create backup table with timestamp
+CREATE TABLE backup_orders_${DATE_YYYYMMDD} AS 
+SELECT * FROM orders WHERE created_at < '${KST_NOW}'
+```
+
+### Debug Mode
+Enable debug mode to see datetime variable substitution:
+```bash
+DEBUG_VARIABLES=true node src/excel-cli.js export --xml queries/my-queries.xml
+```
+
+This will show output like:
+```
+시각 함수 [KST_NOW] 치환: 2024-10-06 00:30:45
+시각 함수 [KOREAN_DATE] 치환: 2024년 10월 6일
+시각 함수 [DATE_YYYYMMDD] 치환: 20241006
+```
+
 ## 🎨 Advanced Features
 
 ### 1. Excel Styling
diff --git a/queries/datetime-variables-example.json b/queries/datetime-variables-example.json
@@ -0,0 +1,38 @@
+{
+  "excel": {
+    "db": "sampleDB",
+    "output": "output/datetime_variables_example_json.xlsx",
+    "style": "business"
+  },
+  "vars": {
+    "reportTitle": "시각 변수 사용 예제 (JSON)",
+    "department": "개발팀"
+  },
+  "sheets": [
+    {
+      "name": "기본시각함수",
+      "use": true,
+      "query": "SELECT '${reportTitle}' as 리포트제목, '${CURRENT_TIMESTAMP}' as 현재시각_UTC, '${NOW}' as 현재시각_NOW, '${CURRENT_DATE}' as 현재날짜, '${CURRENT_TIME}' as 현재시간, '${GETDATE}' as SQL서버형식"
+    },
+    {
+      "name": "한국시간대",
+      "use": true,
+      "query": "SELECT '${KST_NOW}' as 한국현재시각, '${KST_DATE}' as 한국현재날짜, '${KST_TIME}' as 한국현재시간, '${KST_DATETIME}' as 한국날짜시간, '${KST_ISO_TIMESTAMP}' as 한국ISO형식"
+    },
+    {
+      "name": "한국식날짜형식",
+      "use": true,
+      "query": "SELECT '${KOREAN_DATE}' as 한국식날짜, '${KOREAN_DATETIME}' as 한국식날짜시간, '${KOREAN_DATE_SHORT}' as 한국식날짜짧은형식, '${WEEKDAY_KR}' as 한국어요일, '${MONTH_KR}' as 한국어월, '${YEAR_KR}' as 한국어년도"
+    },
+    {
+      "name": "파일명생성예제",
+      "use": true,
+      "query": "SELECT '${department}' as 부서명, 'Report_${DATE_YYYYMMDD}_${department}.xlsx' as 추천파일명, '${KOREAN_DATE} ${WEEKDAY_KR} 리포트' as 제목예시, 'WHERE created_date >= ''${DATE_YYYY_MM_DD}'' AND department = ''${department}''' as 쿼리조건예시"
+    },
+    {
+      "name": "타임스탬프활용",
+      "use": true,
+      "query": "SELECT '${UNIX_TIMESTAMP}' as 유닉스타임스탬프, '${TIMESTAMP_MS}' as 밀리초타임스탬프, '${ISO_TIMESTAMP}' as ISO형식, '${DATETIME_YYYYMMDD_HHMMSS}' as 파일명용시각, 'backup_${DATE_YYYYMMDD}_${department}' as 백업파일명예시"
+    }
+  ]
+}
diff --git a/queries/datetime-variables-example.xml b/queries/datetime-variables-example.xml
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<queries maxRows="1000">
+  <excel db="sampleDB" output="output/datetime_variables_example.xlsx" style="modern">
+  </excel>
+  
+  <vars>
+    <var name="reportTitle">시각 변수 사용 예제</var>
+    <var name="department">IT</var>
+  </vars>
+  
+  <sheets>
+    <!-- 기본 시각 함수들 -->
+    <sheet name="기본시각함수" use="true">
+      <![CDATA[
+        SELECT 
+          '${reportTitle}' as 리포트제목,
+          '${CURRENT_TIMESTAMP}' as 현재시각_UTC,
+          '${NOW}' as 현재시각_NOW,
+          '${CURRENT_DATE}' as 현재날짜,
+          '${CURRENT_TIME}' as 현재시간,
+          '${GETDATE}' as SQL서버형식
+      ]]>
+    </sheet>
+    
+    <!-- 한국 시간대 함수들 -->
+    <sheet name="한국시간대" use="true">
+      <![CDATA[
+        SELECT 
+          '${KST_NOW}' as 한국현재시각,
+          '${KST_DATE}' as 한국현재날짜,
+          '${KST_TIME}' as 한국현재시간,
+          '${KST_DATETIME}' as 한국날짜시간,
+          '${KST_ISO_TIMESTAMP}' as 한국ISO형식
+      ]]>
+    </sheet>
+    
+    <!-- 한국식 날짜 형식 -->
+    <sheet name="한국식날짜형식" use="true">
+      <![CDATA[
+        SELECT 
+          '${KOREAN_DATE}' as 한국식날짜,
+          '${KOREAN_DATETIME}' as 한국식날짜시간,
+          '${KOREAN_DATE_SHORT}' as 한국식날짜짧은형식,
+          '${WEEKDAY_KR}' as 한국어요일,
+          '${MONTH_KR}' as 한국어월,
+          '${YEAR_KR}' as 한국어년도
+      ]]>
+    </sheet>
+    
+    <!-- 다양한 형식들 -->
+    <sheet name="다양한형식" use="true">
+      <![CDATA[
+        SELECT 
+          '${DATE_YYYYMMDD}' as YYYYMMDD형식,
+          '${DATE_YYYY_MM_DD}' as YYYY_MM_DD형식,
+          '${DATETIME_YYYYMMDD_HHMMSS}' as 날짜시간조합형식,
+          '${WEEKDAY_EN}' as 영어요일,
+          '${UNIX_TIMESTAMP}' as 유닉스타임스탬프,
+          '${TIMESTAMP_MS}' as 밀리초타임스탬프
+      ]]>
+    </sheet>
+    
+    <!-- 실제 사용 예제 -->
+    <sheet name="실제사용예제" use="true">
+      <![CDATA[
+        SELECT 
+          '${department}' as 부서명,
+          '리포트 생성일: ${KOREAN_DATE}' as 생성정보,
+          '생성시각: ${KST_NOW}' as 상세시각,
+          '요일: ${WEEKDAY_KR}' as 요일정보,
+          '파일명 형식: Report_${DATE_YYYYMMDD}_${department}' as 파일명예시,
+          'WHERE 조건 예시: created_date >= ''${DATE_YYYY_MM_DD}''' as 쿼리예시
+      ]]>
+    </sheet>
+  </sheets>
+</queries>
diff --git a/src/mssql-helper.js b/src/mssql-helper.js
@@ -72,16 +72,107 @@ class MSSQLHelper {
    * @returns {Object} 타임스탬프 함수들
    */
   getTimestampFunctions() {
+    const now = new Date();
+    const koreaTime = new Date(now.getTime() + (9 * 60 * 60 * 1000)); // UTC+9 (한국 시간)
+    
     return {
-      'CURRENT_TIMESTAMP': () => new Date().toISOString().slice(0, 19).replace('T', ' '), // YYYY-MM-DD HH:mm:ss
-      'CURRENT_DATETIME': () => new Date().toISOString().slice(0, 19).replace('T', ' '), // YYYY-MM-DD HH:mm:ss
-      'NOW': () => new Date().toISOString().slice(0, 19).replace('T', ' '), // YYYY-MM-DD HH:mm:ss
-      'CURRENT_DATE': () => new Date().toISOString().slice(0, 10), // YYYY-MM-DD
-      'CURRENT_TIME': () => new Date().toTimeString().slice(0, 8), // HH:mm:ss
+      // 기본 시각 함수들
+      'CURRENT_TIMESTAMP': () => now.toISOString().slice(0, 19).replace('T', ' '), // YYYY-MM-DD HH:mm:ss
+      'CURRENT_DATETIME': () => now.toISOString().slice(0, 19).replace('T', ' '), // YYYY-MM-DD HH:mm:ss
+      'NOW': () => now.toISOString().slice(0, 19).replace('T', ' '), // YYYY-MM-DD HH:mm:ss
+      'CURRENT_DATE': () => now.toISOString().slice(0, 10), // YYYY-MM-DD
+      'CURRENT_TIME': () => now.toTimeString().slice(0, 8), // HH:mm:ss
+      'GETDATE': () => now.toISOString().slice(0, 19).replace('T', ' '), // SQL Server GETDATE() equivalent
+      
+      // 한국 시간대 함수들
+      'KST_NOW': () => koreaTime.toISOString().slice(0, 19).replace('T', ' '), // 한국 시간 YYYY-MM-DD HH:mm:ss
+      'KST_DATE': () => koreaTime.toISOString().slice(0, 10), // 한국 날짜 YYYY-MM-DD
+      'KST_TIME': () => koreaTime.toISOString().slice(11, 19), // 한국 시간 HH:mm:ss
+      'KST_DATETIME': () => koreaTime.toISOString().slice(0, 19).replace('T', ' '), // 한국 날짜시간
+      
+      // 한국식 날짜 형식
+      'KOREAN_DATE': () => {
+        const kst = new Date(now.getTime() + (9 * 60 * 60 * 1000));
+        return kst.toLocaleDateString('ko-KR', {
+          year: 'numeric',
+          month: 'long',
+          day: 'numeric'
+        });
+      }, // YYYY년 M월 D일
+      'KOREAN_DATETIME': () => {
+        const kst = new Date(now.getTime() + (9 * 60 * 60 * 1000));
+        return kst.toLocaleString('ko-KR', {
+          year: 'numeric',
+          month: 'long',
+          day: 'numeric',
+          hour: '2-digit',
+          minute: '2-digit',
+          second: '2-digit',
+          hour12: false
+        });
+      }, // YYYY년 M월 D일 HH:mm:ss
+      'KOREAN_DATE_SHORT': () => {
+        const kst = new Date(now.getTime() + (9 * 60 * 60 * 1000));
+        return kst.toLocaleDateString('ko-KR', {
+          year: 'numeric',
+          month: '2-digit',
+          day: '2-digit'
+        });
+      }, // YYYY. MM. DD.
+      
+      // 다양한 형식들
+      'DATE_YYYYMMDD': () => {
+        const kst = new Date(now.getTime() + (9 * 60 * 60 * 1000));
+        const year = kst.getFullYear();
+        const month = String(kst.getMonth() + 1).padStart(2, '0');
+        const day = String(kst.getDate()).padStart(2, '0');
+        return `${year}${month}${day}`;
+      }, // YYYYMMDD
+      'DATE_YYYY_MM_DD': () => {
+        const kst = new Date(now.getTime() + (9 * 60 * 60 * 1000));
+        const year = kst.getFullYear();
+        const month = String(kst.getMonth() + 1).padStart(2, '0');
+        const day = String(kst.getDate()).padStart(2, '0');
+        return `${year}-${month}-${day}`;
+      }, // YYYY-MM-DD (한국 시간)
+      'DATETIME_YYYYMMDD_HHMMSS': () => {
+        const kst = new Date(now.getTime() + (9 * 60 * 60 * 1000));
+        const year = kst.getFullYear();
+        const month = String(kst.getMonth() + 1).padStart(2, '0');
+        const day = String(kst.getDate()).padStart(2, '0');
+        const hour = String(kst.getHours()).padStart(2, '0');
+        const minute = String(kst.getMinutes()).padStart(2, '0');
+        const second = String(kst.getSeconds()).padStart(2, '0');
+        return `${year}${month}${day}_${hour}${minute}${second}`;
+      }, // YYYYMMDD_HHMMSS
+      
+      // 타임스탬프 함수들
       'UNIX_TIMESTAMP': () => Math.floor(Date.now() / 1000), // Unix timestamp
       'TIMESTAMP_MS': () => Date.now(), // Milliseconds timestamp
-      'ISO_TIMESTAMP': () => new Date().toISOString(), // ISO 8601 format
-      'GETDATE': () => new Date().toISOString().slice(0, 19).replace('T', ' ') // SQL Server GETDATE() equivalent
+      'ISO_TIMESTAMP': () => now.toISOString(), // ISO 8601 format
+      'KST_ISO_TIMESTAMP': () => koreaTime.toISOString(), // 한국 시간 ISO 8601
+      
+      // 요일 정보
+      'WEEKDAY_KR': () => {
+        const kst = new Date(now.getTime() + (9 * 60 * 60 * 1000));
+        const weekdays = ['일요일', '월요일', '화요일', '수요일', '목요일', '금요일', '토요일'];
+        return weekdays[kst.getDay()];
+      }, // 한국어 요일
+      'WEEKDAY_EN': () => {
+        const kst = new Date(now.getTime() + (9 * 60 * 60 * 1000));
+        const weekdays = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+        return weekdays[kst.getDay()];
+      }, // 영어 요일
+      
+      // 월 정보
+      'MONTH_KR': () => {
+        const kst = new Date(now.getTime() + (9 * 60 * 60 * 1000));
+        return `${kst.getMonth() + 1}월`;
+      }, // N월
+      'YEAR_KR': () => {
+        const kst = new Date(now.getTime() + (9 * 60 * 60 * 1000));
+        return `${kst.getFullYear()}년`;
+      } // YYYY년
     };
   }
 
