Runtime v2.81 · Cập nhật 30 thg 9, 2026

Timer

Đồng hồ bấm giờ theo millisecond dùng để kiểm tra thời lượng và chờ có điều kiện trong script.

Cú pháp

Timer(auto_start=True)

Tham số khởi tạo

TênMô tả
auto_startBoolean
Bắt đầu đếm ngay sau khi tạo timer.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: True

Giá trị trả về

Timer

Hành vi / tác động

Đồng hồ bấm giờ theo millisecond dùng để kiểm tra thời lượng và chờ có điều kiện trong script.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Không có

Thuộc tính

TênMô tả
auto_startBoolean
Timer có bắt đầu đếm ngay sau khi tạo hay không. Gán True để bắt đầu; gán False để tạm dừng.
Mặc định: True
Ví dụ khởi tạo
timer = Timer()
if timer.is_elapsed(500):
    text("half-second passed")

Phương thức

10 phương thức

Timer.start

Bắt đầu đếm nếu timer hiện đang dừng.

Cú pháp

timer.start()

Tham số

Không có

Giá trị trả về

Timer — Trả về chính timer để chain.

Hành vi / tác động

Bắt đầu đếm nếu timer hiện đang dừng.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

# Đo thời gian trong luồng đang gọi
timer = Timer(auto_start=False)
timer.start()
wait(100)
print(timer.elapsed_ms())

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Timer.pause

Tạm dừng đếm nhưng vẫn giữ phần thời gian đã trôi qua.

Cú pháp

timer.pause()

Tham số

Không có

Giá trị trả về

Timer — Trả về chính timer để chain.

Hành vi / tác động

Tạm dừng đếm nhưng vẫn giữ phần thời gian đã trôi qua.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

# Đo thời gian trong luồng đang gọi
timer = Timer()
wait(100)
timer.pause()
print(timer.elapsed_ms())

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Timer.resume

Tiếp tục đếm từ trạng thái tạm dừng.

Cú pháp

timer.resume()

Tham số

Không có

Giá trị trả về

Timer — Trả về chính timer để chain.

Hành vi / tác động

Tiếp tục đếm từ trạng thái tạm dừng.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

# Đo thời gian trong luồng đang gọi
timer = Timer()
timer.pause()
timer.resume()
wait(100)
print(timer.elapsed_ms())

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Timer.stop

Dừng đếm và giữ nguyên số millisecond đã trôi qua.

Cú pháp

timer.stop()

Tham số

Không có

Giá trị trả về

Timer — Trả về chính timer để chain.

Hành vi / tác động

Dừng đếm và giữ nguyên số millisecond đã trôi qua.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

# Đo thời gian trong luồng đang gọi
timer = Timer()
wait(100)
timer.stop()
print(timer.elapsed_ms())

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Timer.reset

Đặt thời gian đã trôi qua về 0 và giữ nguyên trạng thái đang chạy hay tạm dừng.

Cú pháp

timer.reset()

Tham số

Không có

Giá trị trả về

Timer — Trả về chính timer để chain.

Hành vi / tác động

Đặt thời gian đã trôi qua về 0 và giữ nguyên trạng thái đang chạy hay tạm dừng.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

# Đo thời gian trong luồng đang gọi
timer = Timer()
wait(100)
timer.reset()
print(timer.elapsed_ms())

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Timer.restart

Đặt về 0 và bắt đầu đếm lại ngay lập tức.

Cú pháp

timer.restart()

Tham số

Không có

Giá trị trả về

Timer — Trả về chính timer để chain.

Hành vi / tác động

Đặt về 0 và bắt đầu đếm lại ngay lập tức.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

# Đo thời gian trong luồng đang gọi
timer = Timer(auto_start=False)
timer.restart()
wait(100)
print(timer.elapsed_ms())

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Timer.elapsed_ms

Lấy tổng số millisecond đã trôi qua.

Cú pháp

timer.elapsed_ms()

Tham số

Không có

Giá trị trả về

Number — Số millisecond đã trôi qua.

Hành vi / tác động

Lấy tổng số millisecond đã trôi qua.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

# Đo thời gian trong luồng đang gọi
timer = Timer()
wait(100)
print(timer.elapsed_ms())

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Timer.is_elapsed

Kiểm tra xem thời gian đã trôi qua có lớn hơn hoặc bằng số millisecond truyền vào hay chưa.

Cú pháp

timer.is_elapsed(time)

Tham số

TênMô tả
timeNumber
Ngưỡng thời gian theo millisecond cần so sánh.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Boolean — true khi thời gian đã đạt hoặc vượt ngưỡng.

Hành vi / tác động

Kiểm tra xem thời gian đã trôi qua có lớn hơn hoặc bằng số millisecond truyền vào hay chưa.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

# Đo thời gian trong luồng đang gọi
timer = Timer()
wait(500)
if timer.is_elapsed(500):
    print("Elapsed")

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Timer.is_running

Kiểm tra timer hiện có đang đếm hay không.

Cú pháp

timer.is_running()

Tham số

Không có

Giá trị trả về

Boolean — true khi timer đang đếm.

Hành vi / tác động

Kiểm tra timer hiện có đang đếm hay không.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

# Đo thời gian trong luồng đang gọi
timer = Timer()
print(timer.is_running())

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Timer.is_paused

Kiểm tra timer có đang tạm dừng sau khi đã bắt đầu hay không.

Cú pháp

timer.is_paused()

Tham số

Không có

Giá trị trả về

Boolean — true khi timer đang tạm dừng.

Hành vi / tác động

Kiểm tra timer có đang tạm dừng sau khi đã bắt đầu hay không.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

# Đo thời gian trong luồng đang gọi
timer = Timer()
timer.pause()
print(timer.is_paused())

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan