feat: internal date time sensors

docs/sensor/README.md

@@ -15,10 +15,12 @@ Different sensor modes are supported:
 
 ## Sensor Data Sources
 
-The sensor value reading is separated from the `asterctl` tool.
+The sensor value reading is separated from the `asterctl` tool, with the exception of some internal sensors:
+
+- Internal [date time sensors](provider/internal_date_time.md)
 
 Sensor values are provided in separate text files and are automatically read when the file changes.  
-Only the file data source is supported at the moment, other sources like pipes, sockets etc. might be supported later.
+Only the file data source is supported at the moment; other sources like pipes, sockets, etc. might be supported later.
 
 - [Text file data source](provider/text_file.md)
 

docs/sensor/provider/README.md

@@ -1 +1,6 @@
 # Sensor Value Provider
+
+- Internal [date time sensors](internal_date_time.md)
+- Proof of concept [Linux shell scripts](shell_scripts.md)
+- [aster-sysinfo tool](sysinfo.md)
+

docs/sensor/provider/internal_date_time.md

@@ -0,0 +1,34 @@
+# Internal Date Time Sensors
+
+## Individual Components
+
+- `DATE_year`: `{year}`
+- `DATE_month`: `{month}` with leading zero
+- `DATE_day`: `{day}` with leading zero
+- `DATE_hour`: `{hour}` 24h format with leading zero
+- `DATE_minute`: `{minute}` with leading zero
+- `DATE_second`: `{second}` with leading zero
+
+## Month/Day with Hour/Minute
+- `DATE_m_d_h_m_1`: `{month}月{day}日  {hour}:{minute}`
+- `DATE_m_d_h_m_2`: `{month}/{day}  {hour}:{minute}`
+
+## Month/Day Only
+- `DATE_m_d_1`: `{month}月{day}日`
+- `DATE_m_d_2`: `{month}-{day}`
+
+## Year/Month/Day
+- `DATE_y_m_d_1`: `{year}年{month}月{day}日`
+- `DATE_y_m_d_2`: `{year}-{month}-{day}`
+- `DATE_y_m_d_3`: `{year}/{month}/{day}`
+- `DATE_y_m_d_4`: `{year} {month} {day}`
+
+## Hour/Minute/Second
+- `DATE_h_m_s_1`: `{hour}:{minute}:{second}`
+- `DATE_h_m_s_2`: `{hour}时{minute}分{second}秒`
+- `DATE_h_m_s_3`: `{hour} {minute} {second}`
+
+## Hour/Minute Only
+- `DATE_h_m_1`: `{hour}时{minute}分`
+- `DATE_h_m_2`: `{hour} : {minute}`
+- `DATE_h_m_3`: `{hour}:{minute}`