Update docuemnt for v1.3.1

Author: mrjung72

CHANGELOG.md

@@ -1,5 +1,28 @@
 # SQL2Excel Version History
 
+## v1.3.1 - Filename Variables and DATE Fixes (2025-10-30)
+
+### ✨ New/Changed
+- Output filename variable enhancements
+  - Support `${DB_NAME}` in `excel.output` (also normalizes custom syntax `$(DB_NAME}` → `${DB_NAME}`)
+  - Support `${DATE:...}` in `excel.output` using server local time when timezone omitted
+  - Continue to support `${DATE.TZ:...}` for explicit timezones
+- Lowercase token support for DATE formats
+  - Newly supports `yyyy, yy, dd, d, hh, h, sss` in addition to existing uppercase tokens
+  - Safe replacement order from longer to shorter tokens
+- Removed automatic timestamp suffix
+  - No longer appends `_yyyymmddhhmmss` to filenames automatically; use DATE variables in `excel.output` instead
+
+### 🔧 Code Changes
+- `src/index.js`: Apply variable substitution to `excel.output`; inject `DB_NAME`; normalize `$(VAR}` → `${VAR}`; removed auto timestamp append
+- `src/mssql-helper.js`: Extend date formatter to support lowercase tokens; added `formatDateLocal`
+- `src/variable-processor.js`: Use `formatDateLocal` for `${DATE:...}` (local time)
+
+### 📝 Documentation
+- README/README_KR: Added v1.3.1 highlights and filename variable usage examples
+- USER_MANUAL/USER_MANUAL_KR: Documented filename variables (`DB_NAME`, DATE), lowercase tokens, and local-time behavior
+- CHANGELOG/CHANGELOG_KR: Added v1.3.1 entry
+
 ## v1.3.0 - Per-sheet Export for CSV/TXT and Routing Rules (2025-10-29)
 
 ### ✨ New/Changed

CHANGELOG_KR.md

@@ -1,5 +1,28 @@
 # SQL2Excel 버전 히스토리
 
+## v1.3.1 - 파일명 변수 및 DATE 개선 (2025-10-30)
+
+### ✨ 변경 사항
+- 출력 파일명 변수 기능 강화
+  - `excel.output`에서 `${DB_NAME}` 사용 지원 (커스텀 문법 `$(DB_NAME}` → `${DB_NAME}`로 자동 정규화)
+  - 타임존 미지정 `${DATE:...}`는 서버 로컬 시간으로 치환
+  - 타임존 지정 `${DATE.TZ:...}` 계속 지원
+- 날짜 포맷 토큰 소문자 지원
+  - 기존 대문자 토큰 외에 `yyyy, yy, dd, d, hh, h, sss` 지원 추가
+  - 긴 토큰 → 짧은 토큰 순서로 안전 치환
+- 자동 타임스탬프 접미사 제거
+  - 파일명에 `_yyyymmddhhmmss` 자동 추가 제거; 필요 시 `excel.output`에 DATE 변수를 사용하세요
+
+### 🔧 코드 변경
+- `src/index.js`: 출력 경로 변수 치환 적용, `DB_NAME` 주입, `$(VAR}` → `${VAR}` 정규화, 자동 타임스탬프 추가 제거
+- `src/mssql-helper.js`: 날짜 포맷터에 소문자 토큰 지원 추가, `formatDateLocal` 추가
+- `src/variable-processor.js`: `${DATE:...}`(로컬 시간) 처리 시 `formatDateLocal` 사용
+
+### 📝 문서
+- README/README_KR: v1.3.1 하이라이트 및 파일명 변수 예시 추가
+- USER_MANUAL/USER_MANUAL_KR: 파일명 변수(`DB_NAME`, DATE), 소문자 토큰, 로컬 시간 동작 설명 추가
+- CHANGELOG/CHANGELOG_KR: v1.3.1 항목 추가
+
 ## v1.3.0 - CSV/TXT 시트별 내보내기 및 라우팅 규칙 (2025-10-29)
 
 ### ✨ 변경 사항

README.md

@@ -24,6 +24,15 @@ A Node.js-based tool for generating Excel files from SQL query results.
 - ⏰ **Custom DateTime Variables**: Support for 22 timezones worldwide with custom format (`${DATE.UTC:YYYY-MM-DD}`, `${DATE.KST:YYYY년 MM월 DD일}`, `${DATE.EST:YYYY-MM-DD HH:mm}`, etc.) or use local time (`${DATE:YYYY-MM-DD}`)
 - 📋 **SQL Query Formatting**: Preserve original SQL formatting with line breaks in Table of Contents
 - 🔧 **Input Validation**: Automatic whitespace trimming for file path inputs
+- 🗂️ **Filename Variables**: Use `${DATE:...}`, `${DATE.TZ:...}`, and `${DB_NAME}` in `excel.output` (also supports custom `$(DB_NAME}`)
+
+## v1.3.1 Highlights
+
+- Filename variables in output path
+  - Support `${DB_NAME}` (current DB key), custom syntax `$(DB_NAME}` normalized automatically
+  - Support `${DATE:...}` (local time) and `${DATE.TZ:...}` (explicit timezone) in filenames
+  - Lowercase date tokens supported: `yyyy, yy, dd, d, hh, h, sss`
+  - Removed auto `_yyyymmddhhmmss` suffix; control naming via DATE variables
 
 ## v1.3.0 Highlights
 

README_KR.md

@@ -24,6 +24,15 @@ SQL 쿼리 결과를 엑셀 파일로 생성하는 Node.js 기반 도구입니
 - ⏰ **커스텀 DateTime 변수**: 전세계 22개 타임존 지원 및 커스텀 포맷 (`${DATE.UTC:YYYY-MM-DD}`, `${DATE.KST:YYYY년 MM월 DD일}`, `${DATE.EST:YYYY-MM-DD HH:mm}` 등) 또는 로컬 시간 사용 (`${DATE:YYYY-MM-DD}`)
 - 📋 **SQL 쿼리 포맷팅**: 목차에서 줄바꿈을 포함한 원본 SQL 포맷 유지
 - 🔧 **입력 유효성 검증**: 파일 경로 입력에 대한 자동 공백 제거
+- 🗂️ **파일명 변수**: `excel.output`에서 `${DATE:...}`, `${DATE.TZ:...}`, `${DB_NAME}` 사용 가능 (커스텀 `$(DB_NAME}`도 지원)
+
+## v1.3.1 하이라이트
+
+- 출력 경로에서 파일명 변수 지원 강화
+  - `${DB_NAME}` 지원 (현재 기본 DB 키). 커스텀 문법 `$(DB_NAME}`는 자동으로 `${DB_NAME}`로 정규화
+  - `${DATE:...}`(로컬 시간), `${DATE.TZ:...}`(타임존 명시) 파일명에서 사용 가능
+  - 소문자 날짜 토큰 지원: `yyyy, yy, dd, d, hh, h, sss`
+  - 자동 `_yyyymmddhhmmss` 접미사 제거 → DATE 변수로 직접 제어
 
 ## v1.3.0 하이라이트
 

USER_MANUAL.md

@@ -566,6 +566,7 @@ ${DATE:format}
 | `ss` | 2-digit seconds (00-59) | `45` |
 | `s` | Seconds (0-59) | `45` |
 | `SSS` | Milliseconds (000-999) | `123` |
+| `yyyy, yy, dd, d, hh, h, sss` | Lowercase variants supported | `2024, 24, 09, 9, 07, 7, 123` |
 
 ### Common Format Examples
 
@@ -613,6 +614,15 @@ Output: `output/report_20241021_153045.xlsx`
 ```
 Output: `output/report_20241021_183045.xlsx` (using server's local time)
 
+### Filename Variables (Output Path)
+
+- You can use variables in `excel.output` to control file naming:
+  - `${DB_NAME}`: Injects the current default DB key. Custom `$(DB_NAME}` is normalized to `${DB_NAME}`.
+  - `${DATE:...}`: Local time; `${DATE.TZ:...}` for explicit timezone.
+  - Lowercase tokens are supported: `yyyy, yy, dd, d, hh, h, sss`.
+- Automatic suffix removal:
+  - The tool no longer appends `_yyyymmddhhmmss` automatically. Use DATE variables in `excel.output` instead.
+
 #### 2. Use in XML Queries
 ```xml
 <vars>

USER_MANUAL_KR.md

@@ -566,6 +566,7 @@ ${DATE:format}
 | `ss` | 2자리 초 (00-59) | `45` |
 | `s` | 초 (0-59) | `45` |
 | `SSS` | 밀리초 (000-999) | `123` |
+| `yyyy, yy, dd, d, hh, h, sss` | 소문자 토큰 지원 | `2024, 24, 09, 9, 07, 7, 123` |
 
 ### 일반적인 형식 예시
 
@@ -613,6 +614,15 @@ ${DATE:format}
 ```
 출력: `output/report_20241021_183045.xlsx` (서버의 로컬 시간 사용)
 
+### 파일명 변수 (출력 경로)
+
+- `excel.output`에 변수를 사용하여 파일명을 제어할 수 있습니다:
+  - `${DB_NAME}`: 현재 기본 DB 키 주입. 커스텀 `$(DB_NAME}`는 자동으로 `${DB_NAME}`로 정규화됩니다.
+  - `${DATE:...}`: 로컬 시간 사용. `${DATE.TZ:...}`는 타임존을 명시합니다.
+  - 소문자 토큰 지원: `yyyy, yy, dd, d, hh, h, sss`.
+- 자동 접미사 제거:
+  - 더 이상 파일명에 `_yyyymmddhhmmss`가 자동으로 붙지 않습니다. 필요한 경우 `excel.output`에 DATE 변수를 사용하세요.
+
 #### 2. XML 쿼리에서 사용
 ```xml
 <vars>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "sql2excel",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "SQL 쿼리 결과를 엑셀 파일로 저장하는 도구 (시트별 쿼리, 변수, XML/JSON 지원)",
   "main": "app.js",
   "scripts": {