AGENT SKILL
37-variable-datetime
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 3
- 参考文档agents/openai.yaml77 B
- 参考文档mocking.md1.4 KB
- 参考文档tests.md2.2 KB
03 SKILL.md 正文
Devian v11 — Variable: CDateTime
Status: ACTIVE AppliesTo: v11 SSOT: skills/devian/10-module/03-ssot/SKILL.md
Purpose
CDateTime은 UTC epoch millisecond와 DateTime을 함께 유지하는 단순 공용 변수 타입이다.
- 입력 기준:
utcTimeMs(long, Unix epoch ms) - 결과:
dateTime(UTC)
Hard Rules
- client/server 구분 필드(
server*,client*)와 diff/helper API를 두지 않는다. utcTimeMs는DateTime표현 가능 범위로 clamp한다.dateTime은 항상 UTC (DateTimeOffset.FromUnixTimeMilliseconds(...).UtcDateTime)로 생성한다.SetDateTime(DateTime)입력이 UTC가 아니면 UTC로 변환 후 저장한다.CDateTime(string)은 문자열에서 숫자만 추출해 순서대로year(4) -> month(2) -> day(2) -> hour(2) -> minute(2) -> second(2) -> millisecond(3)를 채운다.- 문자열 파싱에서 값이 없으면
0으로 처리하고, 최종DateTime생성 시 유효 범위로 clamp한다.
Public API
[Serializable]
public struct CDateTime : IEquatable<CDateTime>
{
public long utcTimeMs;
public DateTime dateTime;
public CDateTime(long utcTimeMs);
public CDateTime(DateTime dt);
public CDateTime(string raw);
public void Initialize(long utcTimeMs);
public void SetUtcTimeMs(long utcTimeMs);
public void SetDateTime(DateTime dateTime);
public static DateTime ToUtcDateTime(long utcTimeMs);
}
Files (3-path)
framework-cs/module/Devian/src/Variable/CDateTime.csframework-cs/upm/com.devian.foundation/Runtime/Module/Variable/CDateTime.csframework-cs/apps/UnityExample/Packages/com.devian.foundation/Runtime/Module/Variable/CDateTime.cs
Table Authoring
XLSX 테이블에서 class:CDateTime 타입 컬럼으로 사용한다.
- 셀에 datetime 문자열 작성 (예:
2024-03-08 15:30:45.123) - 빌드 시
CDateTime(string raw)파싱 로직을 재현하여utcTimeMslong 값으로 변환 - NDJSON/pb64에는
utcTimeMslong 값만 저장
DFF 규약: skills/devian/80-tools/11-builder/30-table-cell-format/SKILL.md
DoD
- [ ]
CDateTime가 3-path 모두 동일 구현으로 존재 - [ ] client/server 구분 및 diff/helper API 제거
- [ ]
utcTimeMs,dateTime단일 모델 유지 - [ ]
DateTime,string생성자 2개 제공 - [ ] 테스트 코드는 추가하지 않음 (요청 사항)
Reference
- Parent:
skills/devian/10-module/20-core/00-overview/SKILL.md