CogniTabเอกสาร Script
/

Runtime v2.81 · อัปเดต 30 ก.ย. 2569

Timer

Class

ตัวช่วยนาฬิกาจับเวลาระดับมิลลิวินาทีสำหรับตรวจสอบเวลาสคริปต์และการรอคอยที่ปลอดภัย

รูปแบบคำสั่ง

Timer(auto_start=True)

พารามิเตอร์สำหรับสร้างออบเจ็กต์

ชื่อคำอธิบาย
auto_startBoolean
Start counting immediately after creation.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: True

ค่าที่ส่งกลับ

Timer

พฤติกรรม / ผลข้างเคียง

ตัวช่วยนาฬิกาจับเวลาระดับมิลลิวินาทีสำหรับตรวจสอบเวลาสคริปต์และการรอคอยที่ปลอดภัย

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์

ตัวอย่าง

timer = Timer(auto_start=False)
timer.start()
while not timer.is_elapsed(2000):
    wait(50)
timer.stop()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

ไม่มี

ฟิลด์

ชื่อคำอธิบาย
auto_startBoolean
Whether the timer starts immediately after creation. Assign True to start; assign False to pause.
ค่าเริ่มต้น: True
ตัวอย่างการสร้างออบเจ็กต์
timer = Timer()
if timer.is_elapsed(500):
    text("half-second passed")

เมธอด

10 เมธอด

Timer.start

Method

เริ่มนับหากตัวจับเวลาหยุดอยู่ในขณะนี้

รูปแบบคำสั่ง

timer.start()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

Timer — ส่งกลับตัวจับเวลาเดียวกันสำหรับการผูกมัด

พฤติกรรม / ผลข้างเคียง

เริ่มนับหากตัวจับเวลาหยุดอยู่ในขณะนี้

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์

ตัวอย่าง

# วัดเวลาในโฟลว์ที่เรียกใช้งาน
timer = Timer(auto_start=False)
timer.start()
wait(100)
print(timer.elapsed_ms())

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Timer.pause

Method

Pause counting while preserving elapsed milliseconds.

รูปแบบคำสั่ง

timer.pause()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

Timer — ส่งกลับตัวจับเวลาเดียวกันสำหรับการผูกมัด

พฤติกรรม / ผลข้างเคียง

Pause counting while preserving elapsed milliseconds.

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์

ตัวอย่าง

# วัดเวลาในโฟลว์ที่เรียกใช้งาน
timer = Timer()
wait(100)
timer.pause()
print(timer.elapsed_ms())

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Timer.resume

Method

นับต่อจากสถานะหยุดชั่วคราว

รูปแบบคำสั่ง

timer.resume()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

Timer — ส่งกลับตัวจับเวลาเดียวกันสำหรับการผูกมัด

พฤติกรรม / ผลข้างเคียง

นับต่อจากสถานะหยุดชั่วคราว

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์

ตัวอย่าง

# วัดเวลาในโฟลว์ที่เรียกใช้งาน
timer = Timer()
timer.pause()
timer.resume()
wait(100)
print(timer.elapsed_ms())

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Timer.stop

Method

หยุดนับและหยุดมิลลิวินาทีที่ผ่านไปไว้

รูปแบบคำสั่ง

timer.stop()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

Timer — ส่งกลับตัวจับเวลาเดียวกันสำหรับการผูกมัด

พฤติกรรม / ผลข้างเคียง

หยุดนับและหยุดมิลลิวินาทีที่ผ่านไปไว้

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์

ตัวอย่าง

# วัดเวลาในโฟลว์ที่เรียกใช้งาน
timer = Timer()
wait(100)
timer.stop()
print(timer.elapsed_ms())

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Timer.reset

Method

รีเซ็ตเวลาที่ผ่านไปเป็น 0 ในขณะที่ยังคงสถานะการทำงานปัจจุบันไว้

รูปแบบคำสั่ง

timer.reset()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

Timer — ส่งกลับตัวจับเวลาเดียวกันสำหรับการผูกมัด

พฤติกรรม / ผลข้างเคียง

รีเซ็ตเวลาที่ผ่านไปเป็น 0 ในขณะที่ยังคงสถานะการทำงานปัจจุบันไว้

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์

ตัวอย่าง

# วัดเวลาในโฟลว์ที่เรียกใช้งาน
timer = Timer()
wait(100)
timer.reset()
print(timer.elapsed_ms())

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Timer.restart

Method

รีเซ็ตเวลาที่ผ่านไปเป็น 0 และเริ่มนับทันที

รูปแบบคำสั่ง

timer.restart()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

Timer — ส่งกลับตัวจับเวลาเดียวกันสำหรับการผูกมัด

พฤติกรรม / ผลข้างเคียง

รีเซ็ตเวลาที่ผ่านไปเป็น 0 และเริ่มนับทันที

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์

ตัวอย่าง

# วัดเวลาในโฟลว์ที่เรียกใช้งาน
timer = Timer(auto_start=False)
timer.restart()
wait(100)
print(timer.elapsed_ms())

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Timer.elapsed_ms

Method

อ่านค่ามิลลิวินาทีที่ผ่านไปทั้งหมด

รูปแบบคำสั่ง

timer.elapsed_ms()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

Number — มิลลิวินาทีที่ผ่านไป

พฤติกรรม / ผลข้างเคียง

อ่านค่ามิลลิวินาทีที่ผ่านไปทั้งหมด

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์

ตัวอย่าง

# วัดเวลาในโฟลว์ที่เรียกใช้งาน
timer = Timer()
wait(100)
print(timer.elapsed_ms())

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Timer.is_elapsed

Method

ตรวจสอบว่าเวลาที่ผ่านไปมากกว่าหรือเท่ากับมิลลิวินาทีที่ระบุ

รูปแบบคำสั่ง

timer.is_elapsed(time)

พารามิเตอร์

ชื่อคำอธิบาย
timeNumber
Target milliseconds threshold.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Boolean — เป็นจริงเมื่อเวลาที่ผ่านไปถึงหรือเกินเกณฑ์

พฤติกรรม / ผลข้างเคียง

ตรวจสอบว่าเวลาที่ผ่านไปมากกว่าหรือเท่ากับมิลลิวินาทีที่ระบุ

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์

ตัวอย่าง

# วัดเวลาในโฟลว์ที่เรียกใช้งาน
timer = Timer()
wait(500)
if timer.is_elapsed(500):
    print("Elapsed")

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Timer.is_running

Method

ตรวจสอบว่าตัวจับเวลากำลังนับอยู่หรือไม่

รูปแบบคำสั่ง

timer.is_running()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

Boolean — เป็นจริงเมื่อมีการนับเวลา

พฤติกรรม / ผลข้างเคียง

ตรวจสอบว่าตัวจับเวลากำลังนับอยู่หรือไม่

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์

ตัวอย่าง

# วัดเวลาในโฟลว์ที่เรียกใช้งาน
timer = Timer()
print(timer.is_running())

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

Timer.is_paused

Method

ตรวจสอบว่าตัวจับเวลาหยุดชั่วคราวหลังจากเริ่มต้นแล้วหรือไม่

รูปแบบคำสั่ง

timer.is_paused()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

Boolean — เป็นจริงเมื่อหยุดตัวจับเวลาชั่วคราว

พฤติกรรม / ผลข้างเคียง

ตรวจสอบว่าตัวจับเวลาหยุดชั่วคราวหลังจากเริ่มต้นแล้วหรือไม่

การทำงาน

  • รอให้เสร็จ: ไม่
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ใช่

การทำงานกับค่าทำในโฟลว์ที่เรียก โดยไม่ตั้งใจรอการจับภาพ ท่าทาง หรือข้อมูลจากผู้ใช้ สร้างคอนเทนเนอร์และบิลเดอร์ที่เปลี่ยนค่าได้แยกในแต่ละโฟลว์ การแยกนี้ไม่รับประกันการซิงโครไนซ์ออบเจ็กต์ที่แชร์

ตัวอย่าง

# วัดเวลาในโฟลว์ที่เรียกใช้งาน
timer = Timer()
timer.pause()
print(timer.is_paused())

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง