💥 Rename Giveaway#time to Giveaway#duration

README.md

@@ -88,12 +88,12 @@ client.on('interactionCreate', (interaction) => {
         // /start-giveaway 2d 1 Awesome prize!
         // Will create a giveaway with a duration of two days, with one winner and the prize will be "Awesome prize!"
 
-        const time = interaction.options.getString('time');
+        const duration = interaction.options.getString('duration');
         const winnerCount = interaction.options.getInteger('winner_count');
         const prize = interaction.options.getString('prize');
 
         client.giveawaysManager.start(interaction.channel, {
-            time: ms(time),
+            duration: ms(duration),
             winnerCount,
             prize
         }).then((gData) => {
@@ -104,7 +104,7 @@ client.on('interactionCreate', (interaction) => {
 });
 ```
 
--   **options.time**: the giveaway duration.
+-   **options.duration**: the giveaway duration.
 -   **options.prize**: the giveaway prize. You can [access giveaway properties](https://github.com/Androz2091/discord-giveaways#access-giveaway-properties-in-messages).
 -   **options.winnerCount**: the number of giveaway winners.
 -   **[and many other optional parameters to customize the giveaway - read documentation](https://discord-giveaways.js.org/global.html#GiveawayStartOptions)**
@@ -181,7 +181,7 @@ client.on('interactionCreate', (interaction) => {
 -   **options.newBonusEntries**: the new BonusEntry objects (for example, to change the amount of entries).
 -   **options.newLastChance**: the new options for the last chance system. Will get merged with the existing object, if there.
 
-**Note**: to reduce giveaway time, define `addTime` with a negative number! For example `addTime: -5000` will reduce giveaway time by 5 seconds!
+**Note**: to reduce giveaway duration, define `addDuration` with a negative number! For example `addDuration: -5000` will reduce giveaway duration by 5 seconds!
 
 ### Delete a giveaway
 
@@ -278,7 +278,7 @@ Function to filter members. If true is returned, the member will not be able to
 
 ```js
 client.giveawaysManager.start(interaction.channel, {
-    time: 60000,
+    duration: 60000,
     winnerCount: 1,
     prize: 'Free Steam Key',
     // Only members who have the "Nitro Boost" role are able to win
@@ -292,7 +292,7 @@ client.giveawaysManager.start(interaction.channel, {
 const roleName = 'Nitro Boost';
 
 client.giveawaysManager.start(interaction.channel, {
-    time: 60000,
+    duration: 60000,
     winnerCount: 1,
     prize: 'Free Steam Key',
     // Only members who have the the role which is assigned to "roleName" are able to win
@@ -311,7 +311,7 @@ _The special format would "convert" the external string snowflake into a number,
 
 ```js
 client.giveawaysManager.start(interaction.channel, {
-    time: 60000,
+    duration: 60000,
     winnerCount: 1,
     prize: 'Discord Nitro!',
     lastChance: {
@@ -336,7 +336,7 @@ client.giveawaysManager.start(interaction.channel, {
 
 ```js
 client.giveawaysManager.start(interaction.channel, {
-    time: 60000,
+    duration: 60000,
     winnerCount: 1,
     prize: 'Discord Nitro!',
     pauseOptions: {
@@ -361,7 +361,7 @@ client.giveawaysManager.start(interaction.channel, {
 
 ```js
 client.giveawaysManager.start(interaction.channel, {
-    time: 60000,
+    duration: 60000,
     winnerCount: 1,
     prize: 'Free Steam Key',
     bonusEntries: [  
@@ -384,7 +384,7 @@ const roleName = 'Nitro Boost';
 const roleBonusEntries = 2;
 
 client.giveawaysManager.start(interaction.channel, {
-    time: 60000,
+    duration: 60000,
     winnerCount: 1,
     prize: 'Free Steam Key',
     bonusEntries: [
@@ -440,10 +440,14 @@ You can also pass a `messages` parameter for `start()` function, if you want to
 For example:
 
 ```js
+const duration = interaction.options.getString('duration');
+const winnerCount = interaction.options.getInteger('winnerCount');
+const prize = interaction.options.getString('prize');
+
 client.giveawaysManager.start(interaction.channel, {
-    time: ms(args[0]),
-    winnerCount: parseInt(args[1]),
-    prize: args.slice(2).join(' '),
+    duration: ms(duration),
+    winnerCount,
+    prize,
     messages: {
         giveaway: '🎉🎉 **GIVEAWAY** 🎉🎉',
         giveawayEnded: '🎉🎉 **GIVEAWAY ENDED** 🎉🎉',

src/Constants.js

@@ -49,7 +49,7 @@ exports.GiveawayMessages = {
  * The start options for new giveaways.
  * @typedef GiveawayStartOptions
  *
- * @property {number} time The giveaway duration.
+ * @property {number} duration The giveaway duration (milliseconds).
  * @property {number} winnerCount The number of winners for the giveaway.
  * @property {string} prize The giveaway prize.
  * @property {Discord.User} [hostedBy] The user who hosts the giveaway.

src/Manager.js

@@ -197,7 +197,7 @@ class GiveawaysManager extends EventEmitter {
      * manager.start(message.channel, {
      *      prize: 'Free Steam Key',
      *      // Giveaway will last 10 seconds
-     *      time: 10000,
+     *      duration: 10000,
      *      // One winner
      *      winnerCount: 1,
      *      // Limit the giveaway to members who have the "Nitro Boost" role
@@ -217,8 +217,8 @@ class GiveawaysManager extends EventEmitter {
                         : Discord.Permissions.FLAGS.SEND_MESSAGES
                 ])
             ) return reject(`The manager is unable to send messages in the provided ThreadChannel. (id=${channel.id})`);
-            if (isNaN(options.time) || typeof options.time !== 'number' || options.time < 1) {
-                return reject(`options.time is not a positive number. (val=${options.time})`);
+            if (isNaN(options.duration) || typeof options.duration !== 'number' || options.duration < 1) {
+                return reject(`options.duration is not a positive number. (val=${options.duration})`);
             }
             if (typeof options.prize !== 'string' || options.prize.length > 256) {
                 return reject(`options.prize is not a string or longer than 256 characters. (val=${options.prize})`);
@@ -232,7 +232,7 @@ class GiveawaysManager extends EventEmitter {
 
             const giveaway = new Giveaway(this, {
                 startAt: Date.now(),
-                endAt: Date.now() + options.time,
+                endAt: Date.now() + options.duration,
                 winnerCount: options.winnerCount,
                 channelId: channel.id,
                 guildId: channel.guildId,

typings/index.d.ts

@@ -79,7 +79,7 @@ declare module 'discord-giveaways' {
         };
     }
     interface GiveawayStartOptions {
-        time: number;
+        duration: number;
         winnerCount: number;
         prize: string;
         hostedBy?: User;