Anniversaries

วันครบรอบ

ส่วนประกอบ "วันครบรอบ" คือเซ็นเซอร์แบบกำหนดเองของ Home Assistant ซึ่งจะนับถอยหลังจนถึงวันที่ที่เกิดซ้ำ เช่น วันเกิด แต่ใช้ได้กับวันครบรอบใดๆ ก็ตามที่เกิดขึ้นในวันเดียวกันทุกปี

รายการวันครบรอบใดๆ ที่กำหนดค่าไว้จะถูกเพิ่มลงในปฏิทินผู้ช่วยที่บ้าน นอกจากนี้ยังสร้างเอนทิตี calendar.anniversaries ซึ่งแสดงข้อมูลเกี่ยวกับวันครบรอบที่กำหนดค่าไว้ครั้งถัดไป หมายเหตุ ในขณะนี้ เฉพาะวันครบรอบครั้งต่อไปเท่านั้นที่จะถูกเพิ่มลงในปฏิทิน

สารบัญ

• การติดตั้ง
  • การติดตั้งด้วยตนเอง
  • การติดตั้งผ่าน HACS
• การกำหนดค่า
  • พารามิเตอร์การกำหนดค่า
• รัฐและคุณลักษณะ
  • สถานะ
  • คุณสมบัติ
  • หมายเหตุเกี่ยวกับหน่วยการวัด

การติดตั้ง

การติดตั้งด้วยตนเอง

1. ดาวน์โหลดไฟล์ anniversaries.zip จากรุ่นล่าสุด
2. แตกไฟล์รีลีสและคัดลอกไดเร็กทอรี custom_components/anniversaries ลงในไดเร็กทอรี custom_components ของการติดตั้ง Home Assistant ของคุณ
3. กำหนดค่าเซ็นเซอร์ anniversaries
4. รีสตาร์ทผู้ช่วยที่บ้าน

การติดตั้งผ่าน HACS

1. ตรวจสอบให้แน่ใจว่าได้ติดตั้ง HACS แล้ว
2. ค้นหาและติดตั้งการผสานรวม "วันครบรอบ"
3. กำหนดค่าเซ็นเซอร์ anniversaries
4. รีสตาร์ทผู้ช่วยที่บ้าน

การกำหนดค่า

คุณสามารถกำหนดค่าวันครบรอบได้ในเมนูการผสานรวมหรือใน configuration.yaml

กำหนดค่าโฟลว์

ในการกำหนดค่า/การรวมระบบ คลิกที่ปุ่ม + เลือกวันครบรอบ และกำหนดค่าตัวเลือกในแบบฟอร์ม

การกำหนดค่า yaml

เพิ่มเซ็นเซอร์ anniversaries ใน configuration.yaml ของคุณ ตัวอย่างต่อไปนี้เพิ่มเซ็นเซอร์สองตัว - วันเกิดและวันครบรอบแต่งงานของเช็คสเปียร์!

 # Example configuration.yaml entry

anniversaries :
  sensors :
  - name : Shakespeare's Birthday
    date : ' 1564-04-23 '
  - name : Shakespeare's Wedding Anniversary
    date : ' 1582-11-27 '

พารามิเตอร์การกำหนดค่า

พารามิเตอร์	ไม่จำเป็น	คำอธิบาย
name	เลขที่	ชื่อที่เป็นมิตร
date	ต้องรวม date หรือ date_template ไว้ด้วย	วันที่ในรูปแบบ 'YYYY-MM-DD' (หรือ 'MM-DD' หากไม่ทราบปี)
date_template	ต้องรวม date หรือ date_template ไว้ด้วย	เทมเพลตที่จะประเมินวันที่เริ่มต้น (โปรดทราบว่าสิ่งนี้ใช้ได้เฉพาะในการกำหนดค่า YAML เท่านั้น) เทมเพลตจะต้องส่งคืนสตริงในรูปแบบ 'YYYY-MM-DD' หรือ 'MM-DD' เช่น: date_template: '{{ states("input_datetime.your_input_datetime") | string }}'
count_up	ใช่	true หรือ false เปลี่ยนสถานะที่จะนับจากวันที่ (มีประโยชน์สำหรับเหตุการณ์ที่ไม่เกิดซ้ำ) ค่าเริ่มต้น : false
one_time	ใช่	true หรือ false สำหรับเหตุการณ์ที่เกิดขึ้นครั้งเดียว (ไม่เกิดซ้ำ) ค่าเริ่มต้น : false
show_half_anniversary	ใช่	true หรือ false เปิดใช้งานแอตทริบิวต์ half_anniversary_date และ days_until_half_anniversary ค่าเริ่มต้น : false
unit_of_measurement	ใช่	ป้ายกำกับที่คุณเลือก NB เซ็นเซอร์จะส่งกลับวันเสมอ แต่ตัวเลือกนี้ช่วยให้คุณสามารถแสดงสิ่งนี้ในภาษาที่คุณเลือกโดยไม่ต้องปรับแต่ง
id_prefix	ใช่	ตัวเลือกคำนำหน้าของคุณสำหรับentity_id Default : anniversary_ NB ไม่สามารถเปลี่ยนentity_idจากภายในการรวมระบบได้เมื่อสร้างขึ้นแล้ว คุณรำพึงถึงการลบเอนทิตีของคุณและสร้างใหม่หรือเปลี่ยนชื่อentity_idด้วยตนเองในหน้าการกำหนดค่า -> เอนทิตี
icon_normal	ใช่	ไอคอนเริ่มต้น ค่าเริ่มต้น : mdi:calendar-blank
icon_today	ใช่	ไอคอน หากวันครบรอบเป็นวันนี้ ค่าเริ่มต้น : mdi:calendar-star
days_as_soon	ใช่	ล่วงหน้าหลายวันเพื่อแสดงไอคอนที่กำหนดไว้ใน icon_soon Default : 1
icon_soon	ใช่	ไอคอนหากวันครบรอบคือ 'เร็ว ๆ นี้' ค่าเริ่มต้น : mdi:calendar

รัฐและคุณลักษณะ

สถานะ

• จำนวนวันที่เหลือถึงเหตุการณ์ถัดไป (หรือวันนับตั้งแต่เกิดครั้งล่าสุดหากคุณเลือกตัวเลือกการนับถอยหลัง)

คุณสมบัติ

• ปีที่ครบรอบ: จำนวนปีที่จะเกิดขึ้นนับถอยหลังจนถึง (ไม่แสดงหากไม่ทราบปี)
• ปีปัจจุบัน: จำนวนปีที่ผ่านไปนับตั้งแต่เกิดครั้งแรก (เช่น อายุปัจจุบัน) (ไม่แสดงหากไม่ทราบปี)
• date: วันที่เกิดครั้งแรก (หรือวันที่เกิดครั้งต่อไปหากไม่ทราบปี)
• next_date: วันที่ที่จะเกิดขึ้นครั้งต่อไป
• weeks_remaining: จำนวนสัปดาห์ก่อนวันครบรอบ
• unit_of_measurement: 'วัน' โดยค่าเริ่มต้น สิ่งนี้จะแสดงหลังสถานะ สิ่งนี้ไม่สามารถแปลได้ ดูด้านล่างสำหรับวิธีแก้ปัญหา
• half_anniversary_date: วันที่ครบรอบครึ่งปีถัดไป (หากเปิดใช้งานโดย show_half_anniversary )
• days_until_half_anniversary: ​​จำนวนวันก่อนที่จะถึงวันครบรอบครึ่งปีถัดไป

หมายเหตุเกี่ยวกับหน่วยการวัด

Unit_of_measurement ไม่ สามารถแปลได้ อย่างไรก็ตาม คุณสามารถเปลี่ยนข้อความสำหรับหน่วยการวัดในการกำหนดค่าได้ โปรดทราบว่าเซ็นเซอร์จะรายงานเป็นวันเสมอ ซึ่งช่วยให้คุณแสดงสิ่งนี้ในภาษาของคุณเองได้