The datetime type in pandas comes with a number of useful built-in functions to get additional information about the given date. In this tutorial, we will look at how to check if a date in a pandas dataframe is the first day of a year or not with the help of some examples.

## Using the `is_year_start`

attribute

You can use `is_year_start`

attribute on a pandas series (or a column in a dataframe) containing datetime values with the help the `.dt`

accessor to check if each date is the first date of a year or not.

The following is the syntax –

df["Date"].dt.is_year_start

It returns a boolean pandas series where `True`

represents that the corresponding date is the end date of the year and `False`

represents that it’s not.

## Examples

Let’s now look at some examples of using the above syntax.

First, we will create a sample dataframe to apply the above method.

import pandas as pd # create a dataframe df = pd.DataFrame({ "Date": pd.date_range("2022-12-26", "2023-01-04"), "Sales": [10, 12, 7, 17, 21, 5, 11, 13, 14, 8] }) # display the dataframe df

Output:

Here, we created a dataframe with the date level sales data for an ecommerce website. Notice, we used the pandas `date_range()`

function to get datetime values from “2022-12-26” to “2023-01-04” (both inclusive).

**Data Science Programs By Skill Level**

**Introductory** ⭐

- Harvard University Data Science: Learn R Basics for Data Science
- Standford University Data Science: Introduction to Machine Learning
- UC Davis Data Science: Learn SQL Basics for Data Science
- IBM Data Science: Professional Certificate in Data Science
- IBM Data Analysis: Professional Certificate in Data Analytics
- Google Data Analysis: Professional Certificate in Data Analytics
- IBM Data Science: Professional Certificate in Python Data Science
- IBM Data Engineering Fundamentals: Python Basics for Data Science

**Intermediate ⭐⭐⭐**

- Harvard University Learning Python for Data Science: Introduction to Data Science with Python
- Harvard University Computer Science Courses: Using Python for Research
- IBM Python Data Science: Visualizing Data with Python
- DeepLearning.AI Data Science and Machine Learning: Deep Learning Specialization

**Advanced ⭐⭐⭐⭐⭐**

- UC San Diego Data Science: Python for Data Science
- UC San Diego Data Science: Probability and Statistics in Data Science using Python
- Google Data Analysis: Professional Certificate in Advanced Data Analytics
- MIT Statistics and Data Science: Machine Learning with Python - from Linear Models to Deep Learning
- MIT Statistics and Data Science: MicroMasters® Program in Statistics and Data Science

**🔎 Find Data Science Programs 👨💻 111,889 already enrolled**

Disclaimer: Data Science Parichay is reader supported. When you purchase a course through a link on this site, we may earn a small commission at no additional cost to you. Earned commissions help support this website and its team of writers.

Let’s now check whether the dates in the “Date” represent the first day of a year or not.

df["Date"].dt.is_year_start

Output:

0 False 1 False 2 False 3 False 4 False 5 False 6 True 7 False 8 False 9 False Name: Date, dtype: bool

We get a pandas series of boolean values. Notice that we get `True`

for the date “2023-01-01” which, in fact, is the first day of the year 2023.

Let’s add the result from the `is_`

year`_start`

attribute as an additional column in the above dataframe.

# add new column df["Is First Day of Year"] = df["Date"].dt.is_year_start # display the dataframe df

Output:

You might also be interested in –

- Check if a DataFrame column is of datetime dtype in Pandas
- Get Rows using Datetime Index in Pandas
- Pandas – Add Days to Date (With Examples)
- Pandas – How to Create a date range?
- Pandas – Get only date from datetime
- Pandas – Get Month from Date

**Subscribe to our newsletter for more informative guides and tutorials. ****We do not spam and you can opt out any time.**