# 5.3.4. Hàm thời vụ hành vi (Seasonality theo sự kiện, tháng, ngày, kỳ nghỉ lễ…)

Cấu trúc hàm: seasonality(ticker, event=None, month=None, day=None, before=5, after=5, period=10)

Các tham số

<table><thead><tr><th width="99">Tham số</th><th width="113">Kiểu dữ liệu</th><th>Mô tả</th></tr></thead><tbody><tr><td>ticker</td><td>str</td><td>Mã cổ phiếu muốn theo dõi thời vụ hành vi.</td></tr><tr><td>event</td><td>str</td><td>Sự kiện muốn theo dõi hiệu suất của cổ phiếu trước và sau sự kiện, có thể bỏ trổng. Nếu bỏ trống buộc phải điều tham số month và day. Nếu không bỏ trống chỉ được phép điền 1 trong 5 sự kiện sau: new_year_eve, tet_holiday, commemoration_day, liberation_day, independence_day. </td></tr><tr><td>month</td><td>int</td><td>Có thể bỏ trống, nếu bỏ trống buộc phải điền tham số event. Nếu không bỏ trống điền tháng muốn chọn (từ 1 đến 12)</td></tr><tr><td>day</td><td>int</td><td>Có thể bỏ trống, nếu bỏ trống buộc phải điền tham số event. Nếu không bỏ trống điền ngày muốn chọn</td></tr><tr><td>before</td><td>int</td><td>Số phiến trước ngày nghỉ lễ hoặc ngày bất kỳ muốn thống kê. Mặc định là 5</td></tr><tr><td>after</td><td>int</td><td>Số phiến sau ngày nghỉ lễ hoặc ngày bất kỳ muốn thống kê. Mặc định là 5</td></tr><tr><td>period</td><td>int</td><td>Số năm muốn thống kê. Mặc định là 10</td></tr></tbody></table>

Giá trị trả về: Danh sách phân tích gồm các thông tin sau

* Số năm tăng, số năm giảm
* Tỷ suất sinh lời trung bình
* Trung vị
* Biến động (Std Dev)
* Hiệu suất sinh lời cao nhất
* Hiệu suất sinh lời thấp nhất

Ví dụ về việc phân tích hiệu suất 5 ngày trước và sau Ngày Quốc Khánh của VNINDEX trong vòng 10 năm

```python
from FiinQuantX import FiinSession

username = "REPLACE_WITH_YOUR_USERNAME"
password = "REPLACE_WITH_YOUR_PASSWORD"

client = FiinSession(
    username=username,
    password=password
).login()

client.seasonality(ticker="VNINDEX", event="independence_day")
```

Kết quả trả ra cho ví dụ chạy tại ngày 25/06/2025

```
📈 Seasonality Analysis của mã VNINDEX trước và sau Ngày Quốc Khánh (5 ngày trước / 5 ngày sau):
- Tăng: 4 năm | Giảm: 6 năm
- Tỷ suất sinh lời trung bình: -0.30%
- Trung vị: -0.39%
- Biến động (Std Dev): 1.61%
- Lớn nhất: +1.75%
- Nhỏ nhất: -2.41%
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fiinquant.vn/ham-va-cong-thuc/5.-dinh-luong-and-phan-tich-nang-cao/5.3.-tuong-quan-and-so-sanh/5.3.4.-ham-thoi-vu-hanh-vi-seasonality-theo-su-kien-thang-ngay-ky-nghi-le....md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.